A CLI da Lingo.dev conecta sua base de código a um engine de localização pela configuração do seu projeto. Cada lingo push passa pelo seu engine — aplicando automaticamente sua voz da marca, glossário, regras e configuração do modelo. Sem alterações no código, sem novas dependências.
O que muda#
| Antes | Depois | |
|---|---|---|
| Pipeline de tradução | Pipeline padrão do Lingo.dev | Seu engine de localização |
| Voz da marca | Nenhuma | Aplicada por idioma de destino |
| Glossário | Nenhum | Correspondência semântica em cada solicitação |
| Regras | Nenhuma | Incluídas por idioma de destino |
| Seleção de modelo | Padrão do Lingo.dev | Sua configuração de modelo com fallbacks |
| Avaliação de qualidade | Nenhuma | Seus avaliadores de IA configurados são executados automaticamente |
Configuração#
Conecte ao seu engine
Execute lingo link na raiz do projeto:
lingo linkEscolha (ou crie) uma organização e um engine de localização. link grava orgId e engineId em .lingo/config.json — faça commit para que todas as execuções usem o mesmo engine. Você também pode encontrar o ID de um engine no dashboard; ele começa com eng_ (por exemplo, eng_SxjMwMsfOIsvV1wh).
Autenticação
lingo loginAbre o navegador para autenticar e salva uma sessão. Para CI ou uso não interativo, passe uma chave de API:
lingo login --api-key lk_...…ou defina-a como variável de ambiente:
export LINGO_API_KEY="lk_..."Gere uma chave de API na página API Keys do dashboard.
Push
lingo pushA CLI envia os arquivos de origem para o seu engine e grava os resultados traduzidos de volta no disco — aplicando automaticamente sua voz da marca, glossário, regras e configuração do modelo.
Referência de configuração#
.lingo/config.json#
| Campo | Descrição |
|---|---|
orgId | Organização proprietária do engine. Definida por lingo link. |
engineId | Engine que faz a tradução (eng_...). Definido por lingo link. |
sourceLocale, targetLocales e files funcionam da mesma forma que em qualquer projeto — consulte Configuration.
Variáveis de ambiente#
| Variável | Obrigatória | Padrão | Descrição |
|---|---|---|---|
LINGO_API_KEY | Para CI | - | Sua chave de API do Lingo.dev (em vez de lingo login) |
LINGO_API_URL | Não | https://api.lingo.dev | URL base personalizada da API (para self-hosted ou staging) |
O que esperar#
Toda tradução gerada pela CLI passa pelo pipeline completo do seu engine:
- Voz da marca define o tom e o nível de formalidade por idioma
- Itens do glossário garantem a terminologia exata por meio de correspondência semântica
- Regras aplicam regras linguísticas específicas de cada localidade
- Configurações de modelo selecionam o LLM certo com fallbacks automáticos
- Avaliadores de IA avaliam a qualidade automaticamente após cada solicitação
As traduções aparecem em Reports com o tipo de gatilho api, junto das solicitações da API e das integrações.
