WorkBuddy-API
WorkBuddy-API es un gateway auto-alojado compatible con OpenAI que gestiona múltiples cuentas de CodeBuddy. Centraliza el acceso a modelos de IA mediante OAuth, rotación automática de sesiones y optimización de costos.
Ficha actualizada 26 sept 2026, 6:14 · upstream 26 sept 2026, 5:51 · release sin release detectada
Qué es WorkBuddy-API
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este proyecto actúa como una capa de abstracción sobre múltiples cuentas de CodeBuddy, exponiendo una interfaz unificada compatible con la API de OpenAI en el puerto 7863. Está desarrollado en Go y utiliza Redis para la gestión del estado y la cola de tareas, permitiendo un despliegue sencillo mediante Docker Compose.
La arquitectura se centra en la robustez y la eficiencia económica. Implementa una lógica avanzada de selección de cuentas basada en tres factores: proporción de créditos, tiempo de expiración y compensación por inactividad. Esto asegura que las solicitudes se roten inteligentemente entre cuentas con más recursos o que están a punto de caducar, evitando el agotamiento prematuro de un único proveedor.
Además, ofrece capacidades avanzadas de gestión de sesión (sticky sessions) para mantener el contexto en aplicaciones de chat largo, y mecanismos de protección contra la saturación mediante límites de solicitudes concurrentes por cuenta. Incluye herramientas para monitoreo de costos en tiempo real y estadísticas detalladas sobre el uso de modelos.
- Centralizar múltiples cuentas de IA bajo un único endpoint compatible con OpenAI sin modificar clientes existentes.
- Optimizar costes explotando capas gratuitas (free tiers) y rotando automáticamente cuando se agotan los créditos.
- Mantener sesiones largas de chat coherentes mediante la asignación fija de cuenta por sesión activa.
- Proteger contra bloqueos o fallos de un único proveedor mediante mecanismos de fusión (circuit breaker) y reintentos.
- Monitorear el consumo de créditos y costes en tiempo real a través de endpoints de estadísticas.
- Licencia MIT, permitiendo uso y modificación libre en entornos privados.
- Soporte nativo para despliegue con Docker Compose y archivos de configuración JSON.
- Gestión automática de tokens vía OAuth con refresco sin intervención manual.
- Interfaz compatible con OpenAI (v1/chat/completions) para integración inmediata.
- Estadísticas detalladas de uso por modelo y cuenta disponibles en el endpoint /stats.
- Soporte para múltiples dominios (cn/global) y modelos variados como DeepSeek o GLM.
- Es una herramienta no oficial; depende de los términos de servicio de CodeBuddy y OpenAI.
- Requiere configuración manual inicial de cuentas mediante el script de autenticación OAuth.
- El rendimiento total está limitado por la suma de las cuotas de las cuentas subyacentes.
- La persistencia de datos (auths, data) debe estar fuera del repositorio de código para evitar pérdida al clonar.
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
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.
Desplegar en localhost o red interna. Configurar api_key en config.json para autenticación Bearer. Asegurar que el puerto 7863 esté expuesto correctamente. Requiere Go 1.26+ y Redis. Ejecutar login.sh para añadir cuentas antes del uso productivo.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
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.