La CLI de Lingo.dev conecta tu base de código con un motor de localización a través de la configuración de tu proyecto. Cada lingo push pasa por tu motor y aplica automáticamente tu voz de marca, glosario, reglas y configuración del modelo. Sin cambios en el código ni nuevas dependencias.
Qué cambia#
| Antes | Después | |
|---|---|---|
| Flujo de traducción | Flujo predeterminado de Lingo.dev | Tu motor de localización |
| Voz de marca | Ninguna | Aplicada por idioma de destino |
| Glosario | Ninguno | Se ajusta semánticamente en cada solicitud |
| Reglas | Ninguna | Incluidas por idioma de destino |
| Selección de modelo | Modelo predeterminado de Lingo.dev | Tu configuración de modelo con alternativas automáticas |
| Revisión de calidad | Ninguna | Tus evaluadores de IA configurados se ejecutan automáticamente |
Configuración#
Vincula tu motor
Ejecuta lingo link en la raíz de tu proyecto:
lingo linkElige (o crea) una organización y un motor de localización. link escribe orgId y engineId en .lingo/config.json; haz commit para que todas las ejecuciones usen el mismo motor. También puedes encontrar el ID de un motor en el panel; empieza por eng_ (p. ej., eng_SxjMwMsfOIsvV1wh).
Autentícate
lingo loginSe abrirá un navegador para autenticarte y se guardará una sesión. Para CI o usos no interactivos, pasa una clave de API en su lugar:
lingo login --api-key lk_...…o configúrala como variable de entorno:
export LINGO_API_KEY="lk_..."Genera una clave de API desde la página API Keys del panel.
Haz push
lingo pushLa CLI envía los archivos fuente a tu motor y guarda en disco los resultados traducidos, aplicando automáticamente tu voz de marca, glosario, reglas y configuración del modelo.
Referencia de configuración#
.lingo/config.json#
| Campo | Descripción |
|---|---|
orgId | Organización propietaria del motor. Se configura con lingo link. |
engineId | Motor que realiza la traducción (eng_...). Se configura con lingo link. |
sourceLocale, targetLocales y files funcionan igual que en cualquier proyecto; consulta Configuration.
Variables de entorno#
| Variable | Obligatoria | Valor predeterminado | Descripción |
|---|---|---|---|
LINGO_API_KEY | Para CI | - | Tu clave de API de Lingo.dev (en lugar de lingo login) |
LINGO_API_URL | No | https://api.lingo.dev | URL base personalizada de la API (para entornos autohospedados o de staging) |
Qué puedes esperar#
Cada traducción que genera la CLI pasa por todo el flujo de tu motor:
- Voz de marca define el tono y el nivel de formalidad según el idioma
- Entradas del glosario garantizan una terminología exacta mediante ajuste semántico
- Reglas aplican reglas lingüísticas específicas de cada idioma
- Configuraciones de modelo seleccionan el LLM adecuado con alternativas automáticas
- Evaluadores de IA evalúan la calidad automáticamente después de cada solicitud
Las traducciones aparecen en Reports con el tipo de activación api, junto con las solicitudes de la API y las integraciones.
