# gt: General Translation CLI tool: CLI de traduction
URL: https://generaltranslation.com/fr/docs/cli.mdx
---
title: CLI de traduction
description: Configurez et traduisez votre projet avec l’outil CLI de General Translation
---

## Vue d'ensemble

L'outil CLI de General Translation (`gt`) vous permet de mettre en place l'internationalisation et de traduire automatiquement votre projet dans n'importe quelle [langue prise en charge](/docs/platform/supported-locales).

Il fonctionne avec [`gt-next`](/docs/next), [`gt-react`](/docs/react), [`gt-react-native`](/docs/react-native) et des bibliothèques i18n tierces comme `next-intl` et `i18next`. Vous pouvez également l'utiliser pour traduire des fichiers autonomes (JSON, MDX, HTML, etc.).

## Quickstart

### 1. Configurez votre projet

```bash
npx gt@latest
```

Cela lance l’assistant de configuration, qui va :

* Installer les dépendances nécessaires (par ex. `gt-next` ou `gt-react`)
* Configurer votre framework (plugin Next.js, provider React, etc.)
* Créer un `gt.config.json` avec vos paramètres régionaux et les paramètres de fichier
* Générer des identifiants API


### 2. traduire

```bash
npx gt translate
```

Cette commande traduit votre projet via l’API General Translation. Exécutez-la dans votre pipeline CI/CD **avant** le build de production.

<Callout type="info">
  **Remarque :** Une clé API de production est requise pour la commande `translate`. L’assistant de configuration peut en générer une pour vous, ou vous pouvez en obtenir une sur [generaltranslation.com](https://generaltranslation.com).
</Callout>

C&#39;est tout — deux commandes suffisent pour passer d’un projet monolingue à un projet entièrement traduit.


## Commandes

| Commande                                    | Description                                                                                                        |
| ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| [`npx gt@latest`](/docs/cli/init)           | Exécute l’assistant de configuration. Installe les dépendances, configure votre projet et génère des identifiants. |
| [`npx gt translate`](/docs/cli/translate)   | Traduit votre projet via l’API GT.                                                                                 |
| [`npx gt configure`](/docs/cli/configure)   | Met à jour la configuration GT de votre projet (`gt.config.json`).                                                 |
| [`npx gt auth`](/docs/cli/auth)             | Génère ou actualise les identifiants d’API.                                                                        |
| [`npx gt generate`](/docs/cli/generate)     | Génère un fichier JSON de données de traduction pour une utilisation autonome.                                     |
| [`npx gt upload`](/docs/cli/upload)         | Envoie des fichiers source et des traductions vers la plateforme GT.                                               |
| [`npx gt enqueue`](/docs/cli/enqueue)       | Place les fichiers dans la file d’attente de traduction sans télécharger les résultats.                            |
| [`npx gt download`](/docs/cli/download)     | Télécharge les traductions précédemment mises en file d’attente ou en préparation.                                 |
| [`npx gt stage`](/docs/cli/stage)           | Prépare les traductions pour une révision humaine avant leur publication.                                          |
| [`npx gt save-local`](/docs/cli/save-local) | Enregistre sur la plateforme GT les modifications locales apportées aux traductions.                               |

## Guides

| Guide                                       | Description                                                |
| ------------------------------------------- | ---------------------------------------------------------- |
| [Gestion des branches](/docs/cli/branching) | Suivez séparément les traductions pour chaque branche Git. |
| [FAQ](/docs/cli/faqs)                       | Questions fréquentes sur l’outil CLI.                      |

## Formats pris en charge

La CLI peut traduire des fichiers dans différents formats :

[GT](/docs/cli/formats/gt) · [JSON](/docs/cli/formats/json) · [MDX](/docs/cli/formats/mdx) · [TypeScript/JavaScript](/docs/cli/formats/ts) · [YAML](/docs/cli/formats/yaml) · [PO/POT](/docs/cli/formats/po) · [HTML](/docs/cli/formats/html) · [Texte brut](/docs/cli/formats/txt)