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

title: gt setup
description: Carica i file sorgente e registra un progetto per General Translation. Riferimento API per il comando gt setup.

---

Carica i file sorgente e prepara il progetto per la traduzione, senza scaricare i risultati. Esegue la stessa fase di raccolta e caricamento dei file che [`gt translate`](/docs/cli/reference/commands/translate) esegue prima dell'inizio della traduzione.

Usa `setup` quando vuoi registrare i contenuti sorgente sulla piattaforma come fase separata, ad esempio all'inizio di una pipeline CI suddivisa. Richiede una chiave API di produzione e l'ID progetto.

*Nota: `setup` è disponibile per i progetti base (non framework) e per i framework della famiglia React — `gt-react`, `gt-next`, `gt-react-native` e `gt-tanstack-start`. Non è disponibile per i progetti `gt-node` o Python.*

```bash
npx gt setup
```

## Come funziona [#how-it-works]

1. Legge `gt.config.json` per determinare quali file sorgente raccogliere.
2. Raccoglie i file sorgente traducibili e ne calcola l'hash, nello stesso modo in cui [`gt translate`](/docs/cli/reference/commands/translate) opera prima di tradurre.
3. Carica i file sorgente nuovi e modificati, registrando il progetto sulla piattaforma.
4. Termina senza mettere in coda le traduzioni né scaricare i risultati.

## Flag [#flags]

Il comando `setup` accetta gli stessi flag di [`gt translate`](/docs/cli/reference/commands/translate#flags). Di seguito sono riportati quelli usati più comunemente; il riferimento collegato sopra elenca l'elenco completo.

| Parametro             | Descrizione                                   | Tipo      | Facoltativo | Predefinito      |
| --------------------- | --------------------------------------------- | --------- | ----------- | ---------------- |
| `--api-key <key>`     | Chiave API di produzione.                     | `string`  | Sì          | `GT_API_KEY`     |
| `--project-id <id>`   | ID progetto.                                  | `string`  | Sì          | `GT_PROJECT_ID`  |
| `-c, --config <path>` | Percorso del file di configurazione.          | `string`  | Sì          | `gt.config.json` |
| `--dry-run`           | Raccoglie i file e li elenca senza caricarli. | `boolean` | Sì          | `false`          |

## Esempio [#example]

```bash
# Carica e registra i file sorgente sulla piattaforma
npx gt setup

# Mostra i file che verrebbero caricati senza effettivamente caricarli
npx gt setup --dry-run
```

## Altre note [#notes]

* `setup` viene eseguito anche come fase di registrazione dei file sorgente nella procedura guidata [`gt init`](/docs/cli/reference/commands/init).
* Dopo aver registrato i file sorgente, accoda e scarica le traduzioni con [`gt enqueue`](/docs/cli/reference/commands/enqueue) e [`gt download`](/docs/cli/reference/commands/download), oppure esegui [`gt translate`](/docs/cli/reference/commands/translate) per tradurre tutto in un solo passaggio.