Configuración

Archivo de configuración

yaku almacena la configuración en un archivo YAML. Encuentre su ubicación con:

yaku config path

El archivo se crea automáticamente cuando ejecuta yaku config set por primera vez. También puede editarlo directamente — yaku preserva los comentarios y el formato.

Todos los campos de configuración

Campo	Tipo	Predeterminado	Descripción
`api-key`	`string`		Clave API del LLM para backends locales (Gemini, OpenAI, Anthropic).
`default-target`	`string`		Idioma destino predeterminado. Le permite omitir `--to`.
`backend`	`string`	`hosted`	Backend LLM: `hosted`, `gemini`, `openai`, `anthropic`. Se valida al establecer.
`model`	`string`	predeterminado del `backend`	Sobrescritura del nombre del modelo (ej., `gemini-2.5-flash`, `gpt-4o-mini`).
`api-base`	`string`		URL base de API para cualquier backend local. Comúnmente usado con proveedores compatibles con OpenAI.
`hosted-url`	`string`	`https://api.yakulang.com`	Endpoint de API del servicio alojado. Los endpoints de autenticación se derivan automáticamente (se elimina el prefijo `api.`).
`prompt`	`string`		Ruta a un archivo de prompt de sistema personalizado. Se aplica a cada traducción.

Ejemplo de archivo de configuración

api-key: AIzaSy...su-clave-gemini
default-target: es
backend: gemini
model: gemini-2.5-flash

Gestión de la configuración

# Establecer un valor
yaku config set default-target es

# Leer un valor (solo del archivo, ignora variables de entorno)
yaku config get default-target

# Encontrar el archivo de configuración
yaku config path

Variables de entorno

Las variables de entorno sobrescriben los valores del archivo de configuración. Esto es útil para CI/CD, contenedores o cambiar entre proyectos.

Variable	Sobrescribe campo de config	Ejemplo
`YAKU_API_KEY`	`api-key`	`export YAKU_API_KEY=AIza...`
`YAKU_DEFAULT_TARGET`	`default-target`	`export YAKU_DEFAULT_TARGET=es`
`YAKU_BACKEND`	`backend`	`export YAKU_BACKEND=openai`
`YAKU_MODEL`	`model`	`export YAKU_MODEL=gpt-4o`
`YAKU_API_BASE`	`api-base`	`export YAKU_API_BASE=https://api.groq.com/openai/v1`
`YAKU_HOSTED_URL`	`hosted-url`	`export YAKU_HOSTED_URL=https://api.staging.yakulang.com`

Comportamiento de sobrescritura por variable de entorno

Cuando una variable de entorno YAKU_* está establecida — incluso como cadena vacía — sobrescribe el valor correspondiente del archivo de configuración. Esto previene una alternativa silenciosa cuando una fuente de clave falla:

# Explícitamente vacío → sobrescribe el archivo de config, la clave queda vacía
YAKU_API_KEY="" yaku --backend gemini --to es "test"
# Error: YAKU_API_KEY is set but empty (check your key source).

Alternativas de clave API por backend

Cuando YAKU_API_KEY no está establecida (ni siquiera como cadena vacía) y no hay api-key en el archivo de configuración, yaku verifica estas variables de entorno específicas del backend según el backend resuelto (incluyendo la opción --backend):

Backend	Variable alternativa
`gemini`	`GOOGLE_API_KEY`
`openai`	`OPENAI_API_KEY`
`anthropic`	`ANTHROPIC_API_KEY`

Esto significa que puede usar variables de entorno existentes de otras herramientas (ej., el SDK de Google Cloud o el CLI de OpenAI) sin configuración adicional. Combinado con --backend, puede cambiar entre proveedores sin modificar su configuración:

export GOOGLE_API_KEY=su-clave-gemini
export OPENAI_API_KEY=su-clave-openai
yaku --backend gemini --to es "Hello"
yaku --backend openai --to es "Hello"

Orden de precedencia

Cuando el mismo ajuste se especifica en múltiples lugares, la fuente de mayor prioridad gana:

Opción de línea de comandos (más alta) — ej., --to ja
Variable de entorno — ej., YAKU_DEFAULT_TARGET=ja
Archivo de configuración — ~/.config/yaku/config.yaml
Predeterminado integrado (más baja)

Ejemplo: Si su archivo de configuración tiene default-target: es pero ejecuta yaku --to ja, el idioma destino es ja.

Manejo de errores

Archivo de configuración faltante: yaku usa los predeterminados integrados. Sin error.
Error de sintaxis YAML: yaku registra una advertencia en stderr y continúa con los predeterminados.
Clave de configuración desconocida: yaku config set rechaza claves que no están en la lista anterior.
Valor de configuración inválido: yaku config set valida los valores. El backend debe ser uno de hosted, gemini, openai, anthropic. El campo default-target debe ser un código de idioma BCP 47 válido.