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

title: gt setup
description: Téléverse les fichiers source et enregistre un projet dans General Translation. Référence d’API pour la commande gt setup.

---

Téléverse vos fichiers source et configure le projet pour la traduction, sans télécharger les résultats. Exécute la même étape de collecte et de téléversement des fichiers que [`gt translate`](/docs/cli/reference/commands/translate) avant de lancer la traduction.

Utilisez `setup` lorsque vous souhaitez enregistrer votre contenu source sur la plateforme comme étape distincte — par exemple, au début d’un pipeline CI fractionné. Cela nécessite une clé API de production et un ID de projet.

*Remarque : `setup` est disponible pour les projets de base (sans framework) ainsi que pour les frameworks de la famille React — `gt-react`, `gt-next`, `gt-react-native` et `gt-tanstack-start`. Il n’est pas pris en charge pour les projets `gt-node` ou Python.*

```bash
npx gt setup
```

## Fonctionnement [#how-it-works]

1. Lit `gt.config.json` pour déterminer quels fichiers source collecter.
2. Collecte vos fichiers source traduisibles et en calcule l’empreinte, de la même manière que [`gt translate`](/docs/cli/reference/commands/translate) avant de traduire.
3. Téléverse les fichiers source nouveaux ou modifiés, en enregistrant le projet sur la plateforme.
4. Se termine sans mettre les traductions en file d’attente ni télécharger les résultats.

## Options [#flags]

La commande `setup` accepte les mêmes options que [`gt translate`](/docs/cli/reference/commands/translate#flags). Les options les plus couramment utilisées sont indiquées ci-dessous ; la référence liée ci-dessus présente la liste complète.

| Paramètre             | Description                                                      | Type      | Facultatif | Par défaut       |
| --------------------- | ---------------------------------------------------------------- | --------- | ---------- | ---------------- |
| `--api-key <key>`     | Clé d’API de production.                                         | `string`  | Oui        | `GT_API_KEY`     |
| `--project-id <id>`   | ID du projet.                                                    | `string`  | Oui        | `GT_PROJECT_ID`  |
| `-c, --config <path>` | Chemin vers le fichier de configuration.                         | `string`  | Oui        | `gt.config.json` |
| `--dry-run`           | Collecte les fichiers et affiche un rapport sans les téléverser. | `boolean` | Oui        | `false`          |

## Exemple [#example]

```bash
# Téléverser et enregistrer les fichiers source sur la plateforme
npx gt setup

# Afficher les fichiers qui seraient téléversés sans les téléverser
npx gt setup --dry-run
```

## Autres remarques [#notes]

* `setup` sert également d’étape d’enregistrement des fichiers source dans l’assistant [`gt init`](/docs/cli/reference/commands/init).
* Après avoir enregistré les fichiers source, ajoutez les traductions à la file d’attente et téléchargez-les avec [`gt enqueue`](/docs/cli/reference/commands/enqueue) et [`gt download`](/docs/cli/reference/commands/download), ou exécutez [`gt translate`](/docs/cli/reference/commands/translate) pour tout traduire en une seule étape.