# General Translation Knowledge Base: ¿Qué hace el agente Locadex? URL: https://generaltranslation.com/es/kb/what-is-locadex.mdx Docs index: https://generaltranslation.com/llms.txt Description: Locadex es el agente de IA de General Translation que internacionaliza tu código y traduce tu contenido en tu repositorio de GitHub. Sus automatizaciones se ejecutan cuando se abre un pull request, cuando se hace push de un commit o cuando tú las inicias, y cada cambio llega como un pull request. Category: Herramientas para flujos de trabajo Last updated: 2026-10-21 Authors: Kevin Liu, Kevin Wu Published: 2026-10-21 Locadex es el agente de IA de General Translation que internacionaliza tu código y traduce tu contenido en tu repositorio de GitHub, y entrega cada cambio como un pull request. En una aplicación disponible en varios idiomas, cada texto nuevo de la interfaz debe envolverse en llamadas de internacionalización (i18n) y traducirse a cada idioma de destino, y añadir o eliminar un idioma obliga a actualizar la configuración. Cuando se hace a mano, ese trabajo llega después de los cambios en el código, así que una funcionalidad se lanza primero en el idioma de origen y las traducciones llegan más tarde. | Enfoque | Qué hace bien | Cuándo se traduce | Qué te deja a ti | | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | | Solo una biblioteca de i18n (`i18next`, `react-intl`, `next-intl`) | Entornos de ejecución maduros para renderizar traducciones y dar formato a valores | Cada vez que alguien actualiza los archivos de idioma | Reemplazar cada cadena por una clave, añadirla a todos los archivos de idioma y hacer commit de los cambios por tu cuenta | | Un agente de programación que diriges tú, como Cursor o Claude Code con el [prompt inicial](/docs/overview/for-coding-agents#start-prompt) de General Translation | Configura i18n en una sesión que tú supervisas | Cuando tú o tu CI ejecutáis [`npx gt translate`](/docs/cli/reference/commands/translate) | Supervisar la sesión y, después, revisar sus cambios y hacer commit | | General Translation (Locadex) | Su automatización **Generate code** envuelve el texto en llamadas de i18n en cada ejecución, y cada cambio llega como un pull request | Con el disparador que elijas: un pull request, un push o **Run now** | Revisar cada pull request o activar **Auto-merge** | Usa solo una biblioteca de i18n cuando los traductores se encarguen de los archivos de idioma y cada lanzamiento pueda esperar a que terminen. Usa un agente de programación para una configuración inicial puntual que quieras supervisar y, después, ejecuta [`npx gt translate`](/docs/cli/reference/commands/translate) en CI antes de cada compilación. Usa Locadex cuando la aplicación o la documentación cambien en la mayoría de los pull requests y quieras recibir las traducciones de cada cambio en un pull request sin tener que mantener un paso adicional en el flujo. Si tu plataforma no figura en la lista de Locadex, como Vue o Node.js, usa las bibliotecas de General Translation y la CLI `gt`. ## Video The video is narrated in English, with English captions. [What does the Locadex agent do?](https://caxecubb9c64cezv.public.blob.vercel-storage.com/films/kb-what-is-locadex.mp4) (49 s) General Translation uses its AI agent Locadex to open pull requests that translate your app. Connect GitHub in the Dashboard and create an automation from a template: Generate code wraps untranslated text in the right i18n calls, Generate translations and push translates each change into every target language, and Keep locales in sync updates the project when languages change. Run setup with your target languages, merge its pull request, and review Locadex's pull requests or turn on auto-merge. ## Qué automatiza Locadex Los equipos configuran cuándo se ejecuta cada automatización de Locadex, qué modifica y cómo se entregan los cambios en GitHub. Cada automatización parte de una de las tres plantillas disponibles en **Project > Automations**: * **Generate code** detecta el texto de la interfaz sin traducir y lo envuelve en llamadas de i18n, como el componente [``](/docs/react/reference/components/t). * **Generate translations and push** traduce el contenido de origen nuevo o actualizado a todos los idiomas de destino. * **Keep locales in sync** actualiza los archivos del proyecto cuando se agregan o eliminan idiomas. Locadex es compatible con Next.js; con aplicaciones de React creadas con Vite, Gatsby, Redwood, React Router, TanStack Start (su biblioteca `gt-tanstack-start` es experimental), entre otros, y con los frameworks de documentación Mintlify, Fern y Docusaurus. ## Cómo funciona Locadex requiere un plan Starter o el Plan empresarial, y sus ejecuciones se miden en Unidades de cómputo de Locadex (LCU); consulta las tarifas vigentes en la [página de precios](https://generaltranslation.com/pricing). Conecta GitHub en **Project > Integrations > Catalog**, crea una automatización y haz clic en **Run setup** para elegir la configuración regional de origen y los idiomas de destino (por ejemplo, de inglés a español, francés y japonés). En una aplicación React, la configuración inicial abre un pull request que configura la carga de traducciones sin modificar tus cadenas. Una vez que lo fusiones, **Generate code** las envuelve en llamadas como [``](/docs/react/reference/components/t), que en una página de Next.js queda así: ```tsx title="app/page.tsx" import { T } from 'gt-next'; export default function Home() { return (

Welcome to my app

This content will be translated automatically.
); } ``` **Run when** define el disparador de cada automatización. Con **A pull request changes**, Locadex se ejecuta cuando se abre o se reabre una pull request, o cuando se marca como lista para revisión; después, abre una pull request aparte y la enlaza en un comentario en la tuya. Con **A commit is pushed**, se ejecuta cuando llegan commits a la rama de destino, normalmente `main`. Con **Started manually**, solo se ejecuta cuando haces clic en **Run now**. **Auto-merge** está desactivado de forma predeterminada; si lo activas, fusiona las pull requests de Locadex cuando se superan las comprobaciones. Las traducciones de Locadex siguen los [grupos de contexto](/docs/platform/dashboard/guides/defining-context-for-translations) asignados a tu Project de General Translation (un glosario que fija los términos del producto y prompts personalizados que definen el tono). Las ediciones hechas en el panel de control llegan a GitHub por la misma vía: la siguiente ejecución de traducción de Locadex incorpora esas ediciones en una pull request. ## Configurar el repositorio Usa [comandos de preprocesamiento](/docs/platform/locadex/guides/configuring-automations) para instalar las dependencias y herramientas que tu proyecto necesita en el [sandbox de Locadex](/docs/platform/locadex/reference/vm-image). En un monorepo, establece **Target directory** en la carpeta de la aplicación y empieza los comandos de preprocesamiento con un `cd` a esa carpeta. Revisa manualmente los pull requests de configuración inicial. En los pull requests posteriores generados por automatizaciones, **Auto-merge** requiere que se superen las comprobaciones y que el repositorio tenga los permisos descritos en [Configuración de automatizaciones](/docs/platform/locadex/guides/configuring-automations). Para solicitar una ejecución sobre la revisión actual de un pull request, comenta `/locadex`. La guía de automatizaciones explica cómo funcionan los disparadores y la configuración del repositorio, y el [Inicio rápido de Locadex](/docs/platform/locadex/quickstart) incluye todos los pasos. ## Related questions - [¿Cómo internacionalizo una aplicación con Cursor o Claude Code?](https://generaltranslation.com/es/kb/ai-agent-i18n-setup.mdx): Empieza con el prompt Setup for Agents de General Translation en Cursor o Claude Code, elige una funcionalidad y los idiomas de destino, y deja que el agente implemente y verifique el resultado. El inicio de sesión desde el navegador, la documentación legible por máquinas y las herramientas MCP enlazan la configuración inicial con la traducción y la revisión. Usa Locadex para automatizar la localización continua mediante pull requests. - [¿Cómo agrego i18n a una aplicación de Next.js con App Router?](https://generaltranslation.com/es/kb/add-i18n-to-nextjs.mdx): Empieza con gt init para configurar General Translation en un proyecto compatible con App Router; luego marca el contenido de origen, genera las traducciones y verifica el cambio de idioma. gt-next mantiene el texto en JSX junto con el contexto de traducción; la CLI, el editor del panel de control y Locadex se encargan de la generación, la revisión y las actualizaciones continuas. Esta guía también muestra la configuración inicial explícita con archivos locales. - [¿Cómo traduzco un sitio de documentación de Mintlify?](https://generaltranslation.com/es/kb/translate-mintlify-docs.mdx): Crea una copia traducida de cada página en una carpeta por idioma y añade cada idioma a la navegación de docs.json. El agente de IA de General Translation, Locadex, abre un pull request que añade las páginas traducidas y la navegación por idioma, y después traduce los cambios posteriores. - [¿Cómo mantengo las traducciones actualizadas en cada despliegue?](https://generaltranslation.com/es/kb/translations-in-ci.mdx): Ejecuta la traducción como un paso del flujo antes de cada compilación de producción, para que el texto nuevo se publique ya traducido en el mismo despliegue que lo incorpora. La CLI gt de General Translation lo hace con npx gt translate, usando una clave de API del proyecto y el ID del proyecto almacenados como secretos de CI. - [¿Puedo hacer i18n sin archivos de traducción?](https://generaltranslation.com/es/kb/i18n-without-translation-files.mdx): Sí. Las bibliotecas gt-react y gt-next de General Translation permiten hacer i18n en React y Next.js sin claves de traducción y sin tener que mantener un archivo JSON por idioma. El texto permanece inline en JSX dentro del componente ``, y el comando gt translate genera las traducciones de cada idioma durante la compilación, con contexto extraído de tu código. Locadex puede mantenerlas al día mediante pull requests. ## Previous and next questions - Previous question: [¿Cómo traduzco una app de React Native?](https://generaltranslation.com/es/kb/translate-react-native-app.mdx) ## Sitemap See the [Knowledge Base sitemap](https://generaltranslation.com/es/kb/sitemap.md) for every article.