# python: Archiviazione locale delle traduzioni
URL: https://generaltranslation.com/it/docs/python/guides/local-tx.mdx
---
title: Archiviazione locale delle traduzioni
description: Memorizza le traduzioni localmente anziché recuperarle da una CDN
---

## Cosa sono le traduzioni locali?

Per impostazione predefinita, le librerie Python di GT recuperano le traduzioni dal CDN di General Translation a runtime. Con le traduzioni locali, includi i file di traduzione nel bando della tua app — senza bisogno di richieste di rete esterne.

<Callout>
  **Comportamento predefinito:** GT usa l&#39;archiviazione su CDN per impostazione predefinita. Passa all&#39;archiviazione locale solo se ti servono i vantaggi specifici che offre.
</Callout>

## Trade-off

### Vantaggi della traduzione locale

* **Risposte più rapide**: nessun round-trip di rete per recuperare le traduzioni
* **Nessuna dipendenza da servizi esterni**: la tua app funziona anche se la CDN non è disponibile
* **Funziona offline**: le traduzioni fanno parte del tuo deployment

### Svantaggi delle traduzioni locali

* **Aumento delle dimensioni del deployment**: ogni impostazione regionale supportata aggiunge file di traduzione
* **Nuovo deployment per aggiornare**: per modificare una traduzione è necessario un nuovo deployment

## Setup

### Passaggio 1: Configura la CLI

Installa la CLI di GT e configurala per l&#39;archiviazione locale:

```bash
pip install gtx-cli
gt configure
```

Quando richiesto:

* **Salva nel CDN?** Seleziona &quot;No&quot;
* **Directory delle traduzioni:** Inserisci `./translations`

### Passaggio 2: Genera le traduzioni

```bash
gt translate
```

Questo crea file JSON nella directory `translations/` — uno per ogni impostazione regionale.


### Passaggio 3: Carica le traduzioni nella tua app

Configura la tua app per usare i file di traduzione locali:

<Tabs items={['Flask', 'FastAPI']}>
  <Tab value="Flask">
    ```python
    import json
    from pathlib import Path
    from flask import Flask
    from gt_flask import initialize_gt

    app = Flask(__name__)

    def load_translations(locale: str):
        path = Path('translations') / f'{locale}.json'
        if path.exists():
            return json.loads(path.read_text())
        return {}

    initialize_gt(
        app,
        default_locale='en',
        locales=['es', 'fr', 'ja'],
        load_translations=load_translations,
    )
    ```
  </Tab>

  <Tab value="FastAPI">
    ```python
    import json
    from pathlib import Path
    from fastapi import FastAPI
    from gt_fastapi import initialize_gt

    app = FastAPI()

    def load_translations(locale: str):
        path = Path('translations') / f'{locale}.json'
        if path.exists():
            return json.loads(path.read_text())
        return {}

    initialize_gt(
        app,
        default_locale='en',
        locales=['es', 'fr', 'ja'],
        load_translations=load_translations,
    )
    ```
  </Tab>
</Tabs>

## Integrazione del build

Genera le traduzioni come parte della tua pipeline di deployment:

```yaml title=".github/workflows/deploy.yml"
- name: Generate Translations
  run: gt translate

- name: Deploy
  run: <YOUR_DEPLOY_COMMAND>
```

Oppure in un `Makefile`:

```makefile
deploy:
	gt translate
	<YOUR_DEPLOY_COMMAND>
```

<Callout>
  Genera sempre le traduzioni prima di implementare. Se mancano i file di traduzione, `t()` usa come fallback la stringa originale nella tua `default_locale`.
</Callout>


## Prossimi passi

* [Comando CLI `translate`](/docs/cli/translate) — riferimento sulla generazione delle traduzioni
* [Pattern di traduzione delle stringhe](/docs/python/guides/strings) — come tradurre i contenuti
* [Rilevamento dell&#39;impostazione regionale &amp; middleware](/docs/python/guides/middleware) — come funziona il contesto dell&#39;impostazione regionale