# General Translation Python SDKs: Démarrage rapide
URL: https://generaltranslation.com/fr/docs/python/quickstart.mdx
---

title: Démarrage rapide
description: Installez le SDK Python de General Translation et traduisez votre première application Flask ou FastAPI.
related:
  links:
    - /docs/python/guides/translating-strings
    - /docs/python/guides/detecting-locale
    - /docs/python/guides/declaring-variables
    - /docs/python/guides/storing-translations

---

Le SDK Python de General Translation traduit les chaînes destinées aux utilisateurs dans les applications Flask et FastAPI. Vous l’initialisez une seule fois avec votre application, puis vous entourez les chaînes dans vos routes avec la fonction [`t`](/docs/python/reference/functions/t), qui les traduit selon le paramètre régional de la requête en cours.

Installez l’intégration adaptée à votre framework : `gt-flask` pour Flask, `gt-fastapi` pour FastAPI. Toutes deux reposent sur le runtime partagé `gt-i18n`, que vous pouvez aussi utiliser directement dans un projet sans framework.

<Callout type="warning">
  Le SDK Python est **expérimental et instable** — `gt-i18n`, `gt-flask` et `gt-fastapi` sont tous en version 0.3.0 et peuvent inclure des changements incompatibles. Python 3.10 ou une version ultérieure est requis.
</Callout>

## Ce que fait le SDK Python [#overview]

Le SDK vous offre :

* La **traduction de chaînes** avec `t`, à l’aide de la syntaxe de message ICU.
* La détection du **paramètre régional propre à chaque requête** à partir de l’en-tête `Accept-Language`, ou selon votre propre logique.
* Des **variantes finies** avec [`derive`](/docs/python/reference/functions/derive), et des valeurs non traduisibles avec [`declare_var`](/docs/python/reference/functions/declare-var).
* La **livraison via CDN ou en local** des traductions générées par la [CLI de General Translation](/docs/cli/quickstart).

## Démarrage rapide [#quickstart]

Installez l’intégration, ajoutez un fichier de configuration, initialisez-la dans votre application et traduisez une chaîne de caractères.

### 1. Installez l’intégration

<Tabs items={['Flask', 'FastAPI']}>
  <Tab value="Flask">
    ```bash
    pip install gt-flask
    ```
  </Tab>

  <Tab value="FastAPI">
    ```bash
    pip install gt-fastapi
    ```
  </Tab>
</Tabs>

### 2. Configurez vos paramètres régionaux

Créez un `gt.config.json` à la racine de votre projet avec votre ID de projet et vos paramètres régionaux. Consultez la [référence de configuration](/docs/python/reference/config) pour la description de chaque clé.

```json title="gt.config.json"
{
  "projectId": "your-project-id",
  "defaultLocale": "en",
  "locales": ["es", "fr"]
}
```

### 3. Initialisez votre application

Appelez `initialize_gt(app)` une fois au démarrage. Cette fonction lit `gt.config.json`, configure la détection du paramètre régional pour chaque requête et précharge les traductions. Il n’y a pas de paramètre de clé API — le chargement via CDN utilise `project_id` et `cache_url`.

<Tabs items={['Flask', 'FastAPI']}>
  <Tab value="Flask">
    ```python title="app.py"
    from flask import Flask
    from gt_flask import initialize_gt, t, get_locale

    app = Flask(__name__)
    initialize_gt(app)

    @app.route("/")
    def index():
        return {"message": t("Hello, world!"), "locale": get_locale()}
    ```
  </Tab>

  <Tab value="FastAPI">
    ```python title="main.py"
    from fastapi import FastAPI
    from gt_fastapi import initialize_gt, t, get_locale

    app = FastAPI()
    initialize_gt(app)

    @app.get("/")
    def index():
        return {"message": t("Hello, world!"), "locale": get_locale()}
    ```
  </Tab>
</Tabs>

### 4. Traduire avec des variables

Utilisez des placeholders ICU et passez les valeurs comme arguments nommés.

```python
t("Hello, {name}!", name="Alice")
```

### 5. Générer les traductions

Utilisez la [CLI de General Translation](/docs/cli/quickstart) pour traduire votre contenu avant le déploiement, afin que les traductions soient disponibles à l’exécution.

```bash
gt translate
```

## Utiliser la bibliothèque principale sans framework [#core]

Si vous n’utilisez ni Flask ni FastAPI, installez directement `gt-i18n`. Il n’existe pas de [`initialize_gt`](/docs/python/reference/functions/initialize-gt) dans la bibliothèque principale — créez un [`I18nManager`](/docs/python/reference/classes/i18n-manager), enregistrez-le avec [`set_i18n_manager`](/docs/python/reference/functions/set-i18n-manager), puis définissez vous-même le paramètre régional de la requête.

```bash
pip install gt-i18n
```

```python
from gt_i18n import I18nManager, set_i18n_manager, t

manager = I18nManager(default_locale="en", locales=["es", "fr"])
set_i18n_manager(manager)

manager.set_locale("es")
print(t("Hello, world!"))
```

Voir [Traduire des chaînes](/docs/python/guides/translating-strings) pour en savoir plus sur le contexte et les variables, et [Détecter le paramètre régional de la requête](/docs/python/guides/detecting-locale) pour personnaliser la détection du paramètre régional.
## Next steps

- /docs/python/guides/translating-strings
- /docs/python/guides/detecting-locale
- /docs/python/guides/declaring-variables
- /docs/python/guides/storing-translations