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

title: gt setup
description: Sube los archivos fuente y registra un proyecto en General Translation. Referencia de API para el comando gt setup.

---

Sube tus archivos fuente y deja el proyecto listo para la traducción, sin descargar los resultados. Ejecuta el mismo paso de recopilación y carga de archivos que realiza [`gt translate`](/docs/cli/reference/commands/translate) antes de que comience la traducción.

Usa `setup` cuando quieras registrar tu contenido fuente en la plataforma como un paso independiente; por ejemplo, al inicio de un flujo de CI dividido. Requiere una clave de API de producción y un ID del proyecto.

*Nota: `setup` está disponible para proyectos base (sin framework) y para los frameworks de la familia React: `gt-react`, `gt-next`, `gt-react-native` y `gt-tanstack-start`. No está disponible para proyectos `gt-node` ni de Python.*

```bash
npx gt setup
```

## Cómo funciona [#how-it-works]

1. Lee `gt.config.json` para determinar qué archivos fuente debe recopilar.
2. Recopila y genera hashes de tus archivos fuente traducibles, igual que [`gt translate`](/docs/cli/reference/commands/translate) antes de traducir.
3. Sube los archivos fuente nuevos y modificados, y registra el proyecto en la plataforma.
4. Finaliza sin poner en cola traducciones ni descargar resultados.

## Opciones [#flags]

El comando `setup` acepta las mismas opciones que [`gt translate`](/docs/cli/reference/commands/translate#flags). A continuación se muestran las opciones que se usan con más frecuencia; la referencia enlazada arriba enumera el conjunto completo.

| Parámetro             | Descripción                                               | Tipo      | Opcional | Predeterminado   |
| --------------------- | --------------------------------------------------------- | --------- | -------- | ---------------- |
| `--api-key <key>`     | Clave de API de producción.                               | `string`  | Sí       | `GT_API_KEY`     |
| `--project-id <id>`   | ID del proyecto.                                          | `string`  | Sí       | `GT_PROJECT_ID`  |
| `-c, --config <path>` | Ruta al archivo de configuración.                         | `string`  | Sí       | `gt.config.json` |
| `--dry-run`           | Recopila los archivos e informa sobre ellos sin subirlos. | `boolean` | Sí       | `false`          |

## Ejemplo [#example]

```bash
# Subir y registrar los archivos fuente en la plataforma
npx gt setup

# Mostrar los archivos que se subirían sin subirlos realmente
npx gt setup --dry-run
```

## Otras notas [#notes]

* `setup` también realiza el paso de registro de archivo fuente del asistente de [`gt init`](/docs/cli/reference/commands/init).
* Después de registrar los archivo fuente, pon en cola y descarga las traducciones con [`gt enqueue`](/docs/cli/reference/commands/enqueue) y [`gt download`](/docs/cli/reference/commands/download), o ejecuta [`gt translate`](/docs/cli/reference/commands/translate) para traducir en un solo paso.