key-router
KeyRouter es una puerta de entrada local-first para APIs de LLM que agrupa claves de OpenAI, Anthropic y gateways compatibles tras un único endpoint compatible con OpenAI.
Ficha actualizada 24 sept 2026, 15:40 · upstream 24 sept 2026, 15:27 · release v0.3.3
Qué es key-router
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
KeyRouter es una puerta de entrada local-first para APIs de LLM que agrupa claves de OpenAI, Anthropic y gateways compatibles tras un único endpoint compatible con OpenAI (localhost:9998/v1). Incluye balanceo de carga ponderado, failover automático, conversión entre protocolos (OpenAI/Anthropic), límites de tasa, presupuestos de gasto y facturación. Funciona como aplicación de escritorio en Windows, macOS y Linux.
La arquitectura utiliza Go para el servidor backend con React/Ant Design para la interfaz web integrada. Soporta múltiples ventanas deslizantes para límites de tasa (RPM, TPM, 5h, diario, semanal, mensual) que persisten en SQLite. Incluye conversión transparente entre formatos OpenAI y Anthropic, incluyendo SSE streams, herramientas e imágenes.
El sistema de salud verifica claves con peticiones reales pequeñas (max_tokens:1) para evitar cargas innecesarias. Las actualizaciones son seguras y nunca silenciosas. Los datos se almacenan en directorios estándar del sistema (%LOCALAPPDATA% en Windows, ~/Library/Application Support/KeyRouter en macOS, ~/.local/share/keyrouter en Linux).
- Centralizar múltiples claves de API LLM (OpenAI, Anthropic) tras un único endpoint para clientes SDK o agentes.
- Implementar failover automático entre claves cuando una se agota o falla, sin intervención manual.
- Gestionar presupuestos de gasto y límites de tasa por clave con ventanas deslizantes persistentes.
- Conversión transparente entre protocolos OpenAI y Anthropic para unificar múltiples proveedores.
- Monitoreo local de costes y uso mediante dashboard integrado con seguimiento de tokens en caché.
- Endpoint único compatible con OpenAI (localhost:9998/v1) que agrupa múltiples claves y proveedores.
- Failover automático con clasificación de errores (429, 401, 403, 5xx) y semánticas de retry configurables.
- Conversión bidireccional entre protocolos OpenAI, Anthropic y Responses API incluyendo SSE streams.
- Límites de tasa en 6 ventanas deslizantes (RPM/TPM/5h/diario/semanal/mensual) con persistencia en SQLite.
- Aplicación de escritorio nativa con dashboard web integrado, actualizaciones seguras y trayecto en Windows.
- Seguridad local: bind a 127.0.0.1, defensa DNS-rebinding, CSRF, autenticación opcional por token.
- No incluye Docker ni archivos de composición; requiere instalación manual o paquetes nativos por plataforma.
- Las peticiones de salud son reales y facturables (max_tokens:1), lo que puede generar costes mínimos en claves sensibles.
- La interfaz web se ejecuta localmente sin soporte para despliegues multiusuario remotos.
- Requiere Go 1.26.5+ y Node 20.19+ para construir desde fuente; no es un binario puro.
- Las claves de API solo se almacenan localmente en SQLite; no hay sincronización entre máquinas.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Descargar instalador oficial (.exe, .dmg o .deb) según plataforma. Windows: installer a Program Files o portable .exe. macOS: arrastrar KeyRouter.app a Applications (quitar quarantine si Gatekeeper lo bloquea). Linux: apt install .deb o usar tar.gz/binary directo. Datos en %LOCALAPPDATA%\KeyRouter, ~/Library/Application Support/KeyRouter o ~/.local/share/keyrouter. Configurar KEYROUTER_DATA para override. No exponer al LAN; bind a 127.0.0.1 por defecto.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.