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

title: gt init
description: Ejecuta el asistente de configuración de General Translation para configurar un proyecto. Referencia de la API para el comando `gt init`.

---

`init` es el comando predeterminado: si ejecutas `npx gt` sin ningún comando, se ejecuta.

El asistente detecta tu framework y, según el proyecto, instala dependencias, configura el framework, crea un `gt.config.json` y genera credenciales. Para ver una guía paso a paso, consulta [Configurar la CLI](/docs/cli/guides/configuring).

```bash
npx gt init
```

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

1. Detecta tu framework. Si es un proyecto con Next.js App Router o Mintlify, en su lugar ofrece conectar el agente de IA de [Locadex](/docs/platform/locadex/quickstart).
2. En un proyecto basado en React, instala opcionalmente `gt-react` o `gt-next` y configura el framework (experimental). Las aplicaciones de Vite reciben una inicialización de [`initializeGTSPA`](/docs/react/reference/config#initialize-spa) que se ejecuta antes del punto de entrada de la aplicación existente; las demás aplicaciones de React compatibles usan [`GTProvider`](/docs/react/reference/components/gt-provider).
3. Te pide las configuraciones regionales predeterminada y de destino que falten, y crea o actualiza `gt.config.json`. Se conservan las configuraciones regionales y de archivos existentes. Si usas almacenamiento local de Vite, también crea un archivo para [`loadTranslations`](/docs/react/reference/functions/load-translations) y archivos vacíos para las configuraciones regionales de destino.
4. Instala `gt` como dependencia de desarrollo cuando el flujo de trabajo configurado requiere una instalación persistente de la CLI. La configuración del framework Vite no añade `gt`; sigue ejecutándolo con `npx gt`.
5. Opcionalmente, genera una clave de API y un ID del proyecto, y los escribe en `.env.local`.

*Nota: El paso de configuración de React es experimental y puede no funcionar en todos los proyectos. Revisa los cambios que realiza.*

## Opciones [#flags]

| Parámetro             | Descripción                                       | Tipo       | Opcional | Predeterminado                               |
| --------------------- | ------------------------------------------------- | ---------- | -------- | -------------------------------------------- |
| `--src <paths...>`    | Patrones glob del código fuente de la aplicación. | `string[]` | Sí       | globs de `src`, `app`, `pages`, `components` |
| `-c, --config <path>` | Ruta del archivo de configuración.                | `string`   | Sí       | `gt.config.json`                             |

## Ejemplo [#example]

```bash
# Ejecutar el asistente de configuración completo
npx gt init

# Ejecutar gt sin ningún comando hace lo mismo
npx gt
```

## Otras notas [#notes]

* `init` ejecuta los mismos pasos que [`gt configure`](/docs/cli/reference/commands/configure) y [`gt auth`](/docs/cli/reference/commands/auth) juntos, además del asistente experimental de configuración de React. Ejecuta cualquiera de esos comandos por separado para repetir solo ese paso. No ejecuta [`gt setup`](/docs/cli/reference/commands/setup), que sube tus archivos de origen.
* En un monorepo, ejecuta `init` desde el directorio de la app específico. El comando se detiene sin cambiar archivos cuando el directorio actual es la raíz de un workspace con `pnpm-workspace.yaml` o un campo `workspaces`.
* La configuración automática no está disponible para aplicaciones Electron.
* La clave de API y el ID del proyecto no son necesarios para usar `gt-react` o `gt-next`; solo se necesitan para hacer llamadas a la API de General Translation.
* Si la configuración experimental de React no funciona en tu proyecto, configúralo manualmente siguiendo la documentación de [React](/docs/react/react-quickstart).