Ctrl K
ComunidadGuías…
GITHUB · ANALIZADO

CliRelay

CliRelay es un proxy auto-alojado para herramientas de IA CLI que unifica múltiples proveedores (OpenAI, Claude, Gemini) bajo un endpoint único. Incluye panel web multi-inquilino, gestión de cuotas, registros de peticiones y balanceo de carga con failover automático.

Ficha actualizada 28 sept 2026, 5:23 · upstream 28 sept 2026, 4:51 · release v0.5.5

Ver códigoProblemas y ayudaRepositorio ↗
00

Qué es CliRelay

Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.

CliRelay actúa como una capa de gestión centralizada para suscripciones de IA CLI, permitiendo el uso de credenciales OAuth o claves API existentes a través de cualquier cliente compatible con OpenAI. El sistema está construido en Go 1.26 y Next.js, utilizando PostgreSQL como fuente de verdad para datos persistentes (logs, usuarios) y Redis para estado en tiempo real, caché y colas.

Ofrece capacidades avanzadas de gobernanza multi-tenant, con roles granulares, auditoría de seguridad y gestión de inquilinos independientes. Permite agrupar canales por proveedor, configurar rutas personalizadas y aplicar políticas de cuotas por clave o usuario. La interfaz de administración (/manage) soporta inglés, chino y ruso, ofreciendo edición visual de configuración y modo oscuro para operaciones prolongadas.

Incluye soporte nativo para multimodalidad (texto e imágenes), llamadas a funciones y streaming SSE. El sistema integra un motor de moderación de contenido configurable y rastreo de latencia por canal, facilitando la optimización del rendimiento mediante failover automático ante errores o agotamiento de cuotas en proveedores específicos.

CASOS DE USO
  • Unificar múltiples suscripciones de IA CLI bajo un único endpoint para aplicaciones existentes.
  • Gestionar y auditar el uso de tokens y latencia entre diferentes proveedores (OpenAI, Anthropic, Google).
  • Implementar gobernanza multi-tenant en entornos corporativos con roles granulares y auditoría.
  • Crear paneles de control para usuarios finales que gestionen sus propias claves API sin intervención admin.
PUNTOS DESTACADOS
  • Arquitectura híbrida Go/Next.js con PostgreSQL y Redis para persistencia robusta y estado en tiempo real.
  • Panel web multi-idioma (/manage) con editor visual de configuración y modo oscuro integrado.
  • Motor de balanceo de carga inteligente con failover automático entre claves API del mismo proveedor.
  • Soporte completo para OAuth, credenciales de dispositivo y claves API para múltiples proveedores (Gemini, Claude, etc.).
PRECAUCIONES
  • Dependencia de infraestructura externa (PostgreSQL, Redis) que requiere configuración inicial compleja.
  • Requiere al menos 4 núcleos CPU y 8 GB RAM según especificaciones recomendadas para producción.
  • La gestión de claves API en el frontend puede requerir permisos adicionales de CORS configurados correctamente.
VISUAL

Capturas del proyecto

Imágenes reales detectadas en la documentación del repositorio.

Dashboard with request, token, cost and cache metricsCliRelay portal landing pageMonitor center with model distribution and daily usage trendRequest log table with latency and token metrics per callRuntime error logs with per-request diagnostics and downloadProvider channels grouped by upstream typeAI account cards with quota windows and healthPortal accounts holding multiple API keys each
01

Perfil de infraestructura

Estimación inicial derivada del repositorio y de los servicios detectados.

CPU4 vCPUrecomendación inicial
MEMORIA8 GBRAM estimada
DISCO30 GBalmacenamiento base
COMPLEJIDADmediumnivel de operación
02

Despliegue detectado

Qué señales reales de instalación hemos encontrado.

Listo para automatizar

Desplegar con Docker Compose, asegurando volúmenes persistentes para PostgreSQL y Redis. Configurar variables de entorno para autenticación OAuth y límites de cuotas. Asegurar que los puertos 8317 (API) y 8085 (Panel) estén abiertos. Recomendar TLS para tráfico externo y monitoreo activo de logs en PostgreSQL.

✓Dockerfile
✓Compose
✓One-click
03

Stack y dependencias

Componentes inferidos a partir de manifests, configuración y documentación.

FRAMEWORKS
Next.jsGo
SERVICIOS
PostgreSQLRedisS3/MinIO
BASES DE DATOS
PostgreSQLRedis
PUERTOS
831780851455545455112111451
05

Puede sustituir a

Relaciones detectadas por el análisis del repositorio y su categoría.

06

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.