# gt-node: General Translation Node.js SDK: Inicio rápido
URL: https://generaltranslation.com/es/docs/node/quickstart.mdx
---

title: Inicio rápido
description: Instala la biblioteca `gt-node` de General Translation y traduce tu primer servicio de Node.js.
related:
  links:
    - /docs/node/guides/translating-strings
    - /docs/node/guides/detecting-locale
    - /docs/node/guides/configuring
    - /docs/node/guides/storing-translations

---

`gt-node` traduce cadenas en servidores y servicios de Node.js. Lo inicializas una sola vez, asocias la configuración regional a cada solicitud entrante y traduces cadenas en tus manejadores de solicitud.

Usa `gt-node` para servicios de backend, como APIs de Express o Fastify. Para aplicaciones de React, usa [`gt-react`](/docs/react/react-quickstart); para Next.js, usa [`gt-next`](/docs/react/nextjs-quickstart).

*Nota: `gt-node` requiere Node.js 18 o posterior. La asociación de la configuración regional por solicitud usa `AsyncLocalStorage` de `node:async_hooks`.*

## Lo que hace gt-node [#what-it-does]

`gt-node` te ofrece:

* **traducción de cadenas** con [`getGT`](/docs/node/reference/functions/get-gt), para cadenas locales del manejador de solicitud.
* **Mensajes registrados** con [`msg`](/docs/node/reference/functions/msg) y [`getMessages`](/docs/node/reference/functions/get-messages), para constantes compartidas y errores.
* **Traducción en tiempo de ejecución** con [`tx`](/docs/node/reference/functions/tx), para contenido dinámico.
* Asociación de **configuración regional por solicitud** con [`withGT`](/docs/node/reference/functions/with-gt), además de utilidades para detectar la configuración regional de la solicitud.

## Inicio rápido [#quickstart]

Instala la biblioteca, inicialízala, asocia una configuración regional a cada solicitud y traduce una cadena.

### 1. Instala `gt-node`

Instala `gt-node` como dependencia y la [CLI de `gt`](/docs/cli/quickstart) como dependencia de desarrollo.

<Tabs items={['npm', 'yarn', 'bun', 'pnpm']}>
  <Tab value="npm">
    ```bash
    npm install gt-node && npm install gt --save-dev
    ```
  </Tab>

  <Tab value="yarn">
    ```bash
    yarn add gt-node && yarn add --dev gt
    ```
  </Tab>

  <Tab value="bun">
    ```bash
    bun add gt-node && bun add --dev gt
    ```
  </Tab>

  <Tab value="pnpm">
    ```bash
    pnpm add gt-node && pnpm add --save-dev gt
    ```
  </Tab>
</Tabs>

### 2. Inicializa la biblioteca

Llama a [`initializeGT`](/docs/node/reference/functions/initialize-gt) una sola vez al inicio, antes de procesar solicitudes. Pasa tus locales y credenciales; `gt-node` no lee `gt.config.json` ni las variables de entorno automáticamente.

```ts title="server.js"
import { initializeGT } from 'gt-node';

initializeGT({
  defaultLocale: 'en',
  locales: ['en', 'es', 'fr'],
  projectId: process.env.GT_PROJECT_ID,
});
```

### 3. Asocia la configuración regional de la solicitud

Envuelve cada solicitud con `withGT` para que las funciones de traducción sepan cuál es la configuración regional de destino. Usa [`getRequestLocale`](/docs/node/reference/functions/get-request-locale) para detectarla a partir de la cabecera `Accept-Language`.

```ts title="server.js"
import express from 'express';
import { withGT, getRequestLocale } from 'gt-node';

const app = express();
app.use((req, res, next) => withGT(getRequestLocale(req), () => next()));
```

### 4. Traduce una cadena

Dentro de un manejador de solicitud, usa `await getGT` para obtener una función de traducción para la configuración regional de la solicitud y luego traduce cadenas. Interpola valores con marcadores de posición de ICU.

```ts title="server.js"
import { getGT } from 'gt-node';

app.get('/api/greeting', async (req, res) => {
  const gt = await getGT();
  res.json({ message: gt('Hello, {name}!', { name: 'Alice' }) });
});
```

### 5. Genera traducciones

Ejecuta la CLI antes de desplegar en producción para que las traducciones estén disponibles en runtime.

```bash
npx gt translate
```

Consulta [Traducir cadenas](/docs/node/guides/translating-strings) para saber cuándo usar `getGT`, `msg` y `tx`, y [Configurar gt-node](/docs/node/guides/configuring) para obtener información sobre las credenciales y la entrega.
## Next steps

- /docs/node/guides/translating-strings
- /docs/node/guides/detecting-locale
- /docs/node/guides/configuring
- /docs/node/guides/storing-translations