Configuración

La configuración usa TOML con versión de esquema. El validador rechaza campos no reconocidos y valores inválidos antes de que se inicie el servicio.

Configuración desde la aplicación

La aplicación de escritorio ofrece el recorrido habitual sin editar TOML:

En Providers, añade LM Studio, Ollama, OpenAI, Anthropic o un endpoint compatible. Las claves se guardan en el almacén de credenciales de macOS.
En Models & routes, crea un alias estable, selecciona el proveedor e indica el nombre real del modelo que ese proveedor espera.
Vuelve a Chat y selecciona el alias o una ruta.

LiteGate empieza sin proveedores ni modelos ficticios. El gateway puede estar activo en 127.0.0.1:4100, pero Chat permanece bloqueado hasta que exista al menos un modelo configurado.

Un ejemplo disponible

El repositorio incluye tests/fixtures/config/valid-phase1.toml:

version = 1

[server]
listen = "127.0.0.1:4000"
request_timeout_ms = 120000
max_body_bytes = 1048576
max_concurrent_requests = 16

[[providers]]
id = "mock"
kind = "openai-compatible"
base_url = "http://127.0.0.1:4100/v1"
locality = "local"
authentication = "none"

[[models]]
id = "mock-chat"
provider = "mock"
upstream_model = "mock-chat-v1"

El destino mock es una configuración de ejemplo: este archivo no arranca un servidor de modelos. LiteGate tampoco ejecuta ni descarga modelos de usuario.

Seleccionar y validar el archivo

Usa una ruta explícita para obtener un resultado reproducible:

cargo run -p litegate-cli -- config validate --config tests/fixtures/config/valid-phase1.toml

También existe la variable LITEGATE_CONFIG. La selección da prioridad a --config, después a esa variable y finalmente a la ruta de la plataforma. Si estás empezando, utiliza --config para evitar ambigüedades.

La validación no verifica disponibilidad de red, credenciales ni capacidades reales del modelo. Los secretos de proveedores se gestionan mediante el almacén de credenciales del sistema operativo; no los añadas al ejemplo.