# gt: General Translation CLI tool: gt init
URL: https://generaltranslation.com/fr/docs/cli/reference/commands/init.mdx
---

title: gt init
description: Exécute l’assistant de configuration de General Translation pour configurer un projet. Référence API de la commande gt init.

---

`init` est la commande par défaut : exécuter `npx gt` sans commande lance `init`.

L’assistant de configuration détecte votre framework et, selon le projet, installe les dépendances, configure votre framework, crée un `gt.config.json` et génère les identifiants. Pour un guide pas à pas, consultez [Configurer le CLI](/docs/cli/guides/configuring).

```bash
npx gt init
```

## Fonctionnement [#how-it-works]

1. Détecte votre framework. Pour un projet Next.js App Router ou Mintlify, il propose à la place de connecter l’[agent IA Locadex](/docs/platform/locadex/quickstart).
2. Pour un projet basé sur React, installe éventuellement `gt-react` ou `gt-next` et configure le framework (expérimental). Les applications Vite reçoivent un amorçage [`initializeGTSPA`](/docs/react/reference/config#initialize-spa) qui s’exécute avant le point d’entrée de l’application existante ; les autres applications React prises en charge utilisent [`GTProvider`](/docs/react/reference/components/gt-provider).
3. Demande les paramètres régionaux par défaut et cibles manquants, puis crée ou met à jour `gt.config.json`. Les paramètres régionaux et les paramètres de fichiers existants sont préservés. Pour le stockage local Vite, il crée également un fichier [`loadTranslations`](/docs/react/reference/functions/load-translations) et des fichiers vides pour les paramètres régionaux cibles.
4. Installe `gt` comme dépendance de développement lorsque le workflow configuré nécessite une installation persistante de la CLI. La configuration du framework Vite n’ajoute pas `gt` ; continuez à l’exécuter avec `npx gt`.
5. Peut également générer une clé API et un ID de projet, puis les enregistrer dans `.env.local`.

*Remarque : l’étape de configuration React est expérimentale et peut ne pas fonctionner pour tous les projets. Vérifiez les modifications apportées.*

## Options [#flags]

| Paramètre             | Description                                           | Type       | Facultatif | Par défaut                                 |
| --------------------- | ----------------------------------------------------- | ---------- | ---------- | ------------------------------------------ |
| `--src <paths...>`    | Motifs glob pour le code source de l&#39;application. | `string[]` | Oui        | motifs `src`, `app`, `pages`, `components` |
| `-c, --config <path>` | Chemin vers le fichier de configuration.              | `string`   | Oui        | `gt.config.json`                           |

## Exemple [#example]

```bash
# Lancer l'assistant de configuration complet
npx gt init

# Exécuter gt sans commande produit le même résultat
npx gt
```

## Autres remarques [#notes]

* `init` exécute les mêmes étapes que [`gt configure`](/docs/cli/reference/commands/configure) et [`gt auth`](/docs/cli/reference/commands/auth) combinés, ainsi que l’assistant expérimental de configuration pour React. Exécutez l’une de ces commandes seule pour ne répéter que cette étape. Il n’exécute pas [`gt setup`](/docs/cli/reference/commands/setup), qui téléverse vos fichiers source.

- Dans un monorepo, exécutez `init` depuis le répertoire de l’application concernée. La commande s’arrête sans modifier de fichiers lorsque le répertoire actuel est la racine d’un workspace contenant `pnpm-workspace.yaml` ou un champ `workspaces`.
- La configuration automatique n’est pas disponible pour les applications Electron.

* La clé API et l’ID de projet ne sont pas nécessaires pour utiliser `gt-react` ou `gt-next` — ils sont uniquement requis pour appeler l’API de General Translation.
* Si la configuration expérimentale de React ne fonctionne pas pour votre projet, configurez-la manuellement à l’aide de la [documentation React](/docs/react/react-quickstart).