# gt: General Translation CLI tool: Traducción automática
URL: https://generaltranslation.com/es/docs/cli.mdx
---
title: Traducción automática
description: Cómo traducir automáticamente tu proyecto con la herramienta CLI de General Translation
---

```bash
npx gt@latest
```

<Callout type="info">
  **Anteriormente `gtx-cli`:** Esta herramienta ha pasado de llamarse `gtx-cli` a `gt`. Si antes usabas `gtx-cli`, actualiza tus scripts para usar `gt` en su lugar. Todos los comandos permanecen igual.
</Callout>


## Resumen

La herramienta CLI de General Translation (`gt`) te permite traducir automáticamente tu proyecto a cualquiera de los [idiomas compatibles](/docs/platform/supported-locales).

Ofrece compatibilidad nativa con [`gt-next`](/docs/next) y [`gt-react`](/docs/react) en tu proyecto, lo que te permite escanearlo en busca de contenido traducible, traducirlo y generar archivos JSON con los datos de traducción.

La herramienta CLI también puede usarse para generar traducciones para bibliotecas de i18n de terceros, como [next-intl](https://next-intl.dev/) o [i18next](https://react.i18next.com/).

Por último, la herramienta CLI puede usarse para traducir archivos JSON, Markdown, MDX, JS y TS.

<Callout type="warn">
  Se requiere una clave API de producción para el comando `translate`. Obtén una gratis
  en [generaltranslation.com](https://generaltranslation.com).
</Callout>

***

Hay dos comandos principales que debes conocer: `init` y `translate`.

* El [comando `init`](/docs/cli/init) se usa para configurar tu proyecto. Proporciona un asistente
  paso a paso que configurará tu proyecto para la internacionalización, lo que incluye:

- Configurar plugins y proveedores de React
- Generar claves API
- Configurar los locales y la estructura de archivos de tu proyecto

* El [comando `translate`](/docs/cli/translate) está pensado para añadirse a tu pipeline de CI/CD.
  Se usa para escanear tu proyecto en busca de contenido que deba traducirse.
  Luego, el contenido se carga en una CDN o se añade al bundle de tu aplicación para usarse en tiempo de ejecución.

## Primeros pasos

Según la biblioteca de i18n que use tu proyecto, sigue uno de estos tutoriales:

* [gt-next](/docs/cli/formats/gt)
* [gt-react](/docs/cli/formats/gt)
* [gt-react-native](/docs/cli/formats/gt)
* [next-intl](/docs/cli/formats/json)
* [i18next](/docs/cli/formats/json)
* [JSON](/docs/cli/formats/json)
* [Markdown](/docs/cli/formats/mdx)

## Uso

| Comando                                   | Descripción                                                                                                              |
| ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| [`npx gt init`](/docs/cli/init)           | Ejecuta el asistente de configuración de GT.                                                                             |
| [`npx gt configure`](/docs/cli/configure) | Configura la configuración de GT de tu proyecto.                                                                         |
| [`npx gt translate`](/docs/cli/translate) | Traduce tu proyecto mediante la API de GT.                                                                               |
| [`npx gt upload`](/docs/cli/upload)       | Carga archivos fuente y traducciones a la plataforma de General Translation.                                             |
| [`npx gt enqueue`](/docs/cli/enqueue)     | Pone archivos en cola para su traducción sin descargar los resultados.                                                   |
| [`npx gt download`](/docs/cli/download)   | Descarga las traducciones que se pusieron previamente en cola o se prepararon.                                           |
| [`npx gt auth`](/docs/cli/auth)           | Genera una clave API y un ID del proyecto para tu proyecto.                                                              |
| [`npx gt generate`](/docs/cli/generate)   | Genera un nuevo archivo JSON de datos de traducción. Debe usarse cuando la biblioteca se utiliza de forma independiente. |

## Guías

| Guía                             | Descripción                                                      |
| -------------------------------- | ---------------------------------------------------------------- |
| [branching](/docs/cli/branching) | Sigue las traducciones por separado para distintas ramas de Git. |