subpool
Subpool es una plataforma auto-alojada ligera para la asignación y gobernanza de cuotas de suscripciones de IA en equipos.
Ficha actualizada 24 sept 2026, 3:23 · upstream 24 sept 2026, 3:17 · release v0.1.0
Qué es subpool
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Subpool actúa como un plano de control para la gestión de capacidades de suscripciones de IA en entornos empresariales. Está construido con Go 1.24, React y PostgreSQL, permitiendo alojarlo fácilmente mediante Docker Compose. Los administradores combinan cuentas autorizadas en pools, distribuyen claves específicas por empleado y monitorean el consumo restante o la disponibilidad de reinicio. La arquitectura separa el plano de control del almacenamiento de datos sensibles, garantizando que nunca se persistan prompts ni respuestas en la base de datos local.
El sistema expone APIs compatibles con OpenAI (Responses y Chat Completions) y permite configurar autenticación device-code para suscripciones Codex sin necesidad de callbacks localhost. Esto facilita el despliegue en entornos remotos o headless, donde los usuarios configuran su cliente final para enrutar las solicitudes a la instancia Subpool mediante un archivo de configuración local.
- Centralizar múltiples suscripciones de OpenAI/Codex en un único endpoint para toda la organización.
- Asignar claves API específicas a empleados sin exponer credenciales directas del proveedor upstream.
- Auditar el uso agregado de tokens de entrada y salida por clave API para control de costes.
- Implementar fallback automático entre capacidad de suscripción y cuentas pagadas según disponibilidad.
- Gestionar límites de tasa, expiración y revocación de acceso independientemente por empleado.
- No persiste prompts, respuestas ni código fuente en la base de datos local.
- API compatible con OpenAI (Endpoints /v1/responses y /v1/chat/completions).
- Soporte para autenticación device-code sin localhost callback en suscripciones Codex.
- Licencia Apache 2.0 para uso libre, modificación y despliegue auto-alojado.
- Gestión centralizada de salud de cuentas upstream y reinicio de capacidad.
- Requiere Docker Engine y Compose para el despliegue estándar actual.
- Necesita configurar TLS en un reverse proxy externo (SUBPOOL_PUBLIC_URL).
- Límites de memoria por defecto (256 MiB por request) que pueden requerir tuning.
- Dependencia de PostgreSQL para persistencia de estado y autenticación compartida.
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.
Terminar TLS en un reverse proxy y configurar SUBPOOL_PUBLIC_URL con el origen público. Realizar copias de seguridad de PostgreSQL junto con las claves SECRET y HMAC. Ajustar variables de entorno de memoria (SUBPOOL_MAX_REQUEST_BODY_BYTES) según la infraestructura disponible antes de producción.
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.