Gateway de LLM autohospedado que hace de proxy para las API de OpenAI, Anthropic y compatibles, con enrutamiento, failover, registro de solicitudes y un panel web.
bestruirui/octopus
Una puerta de enlace de API para LLM autohospedada y dirigida a usuarios individuales, que agrupa varios proveedores en un único endpoint con conmutación por error y seguimiento de costos.
Alternativa open source a:OpenRouter
- Estrellas
- 2,742
- Forks
- 450
- Issues abiertos
- 16
- Último commit
- hace 16 días
¿Qué es?
Octopus es una puerta de enlace autohospedada que se sitúa entre tus clientes y varios proveedores de LLM. Configuras canales ascendentes para proveedores como OpenAI, Anthropic y Gemini; luego agrupas los canales bajo un único nombre de modelo para que los clientes llamen a un solo endpoint, independientemente del proveedor que atienda la solicitud.
Convierte entre los formatos OpenAI Chat, OpenAI Responses y Anthropic API, por lo que puedes configurar herramientas como Claude Code y Codex para que lo usen cambiando la URL base. Si falla un canal ascendente, las solicitudes pasan automáticamente a otro canal disponible. Los precios de los modelos se sincronizan desde models.dev y se pueden modificar manualmente. Además, las estadísticas de solicitudes, el uso de tokens y los costos se registran y muestran en un panel de administración web.
El proyecto se distribuye como un único binario de Go con una interfaz web integrada, y almacena los datos en SQLite, MySQL o PostgreSQL. También se puede ejecutar con Docker.
Funciones clave
- 01Agrupa varios canales de proveedores de LLM bajo nombres de modelo unificados
- 02Convierte entre los formatos OpenAI Chat, OpenAI Responses y Anthropic API
- 03Cambia automáticamente a otro canal si se produce un error en el canal ascendente
- 04Sincroniza los precios de los modelos y las listas de modelos disponibles desde fuentes ascendentes
- 05Registra el número de solicitudes, el uso de tokens y los costos en un panel web
- 06Se ejecuta como un único binario y almacena los datos en SQLite, MySQL o PostgreSQL
Casos de uso
- Configurar Claude Code o Codex para usar varios proveedores a través de un único endpoint local
- Usar una sola clave de API y un único nombre de modelo para varias cuentas de LLM en una configuración personal
- Mantener en marcha las tareas de los agentes cuando un proveedor ascendente sufra una interrupción
- Controlar en un solo lugar el gasto en tokens de distintos proveedores de LLM
Inicio rápido
- 1
Ejecuta el contenedor de Docker
docker run -d --name octopus -v /path/to/data:/app/data -p 8080:8080 bestrui/octopus - 2
O descarga el binario desde la página de versiones y ejecútalo
./octopus start
Antes de usarlo
- Las credenciales de administrador predeterminadas son admin/admin, así que debes cambiar la contraseña justo después del primer inicio de sesión.
- Las estadísticas se almacenan temporalmente en memoria, por lo que una terminación forzada, como kill -9, puede provocar la pérdida de datos.
- Las bases de datos MySQL y PostgreSQL deben crearse manualmente antes de usarlas.
En colecciones
Temas
Preguntas frecuentes
- ¿Qué es octopus?
- Una puerta de enlace de API para LLM autohospedada y dirigida a usuarios individuales, que agrupa varios proveedores en un único endpoint con conmutación por error y seguimiento de costos. Octopus es una puerta de enlace autohospedada que se sitúa entre tus clientes y varios proveedores de LLM. Configuras canales ascendentes para proveedores como OpenAI, Anthropic y Gemini; luego agrupas los canales bajo un único nombre de modelo para que los clientes llamen a un solo endpoint, independientemente del proveedor que atienda la solicitud.
- ¿octopus es gratuito? ¿Qué licencia tiene?
- octopus es open source bajo la licencia AGPL-3.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
- ¿octopus sigue mantenido?
- Mantenimiento activo. El último commit de octopus fue el 23 oct 2026.
- ¿Para qué puedo usar octopus?
- Configurar Claude Code o Codex para usar varios proveedores a través de un único endpoint local Usar una sola clave de API y un único nombre de modelo para varias cuentas de LLM en una configuración personal Mantener en marcha las tareas de los agentes cuando un proveedor ascendente sufra una interrupción Controlar en un solo lugar el gasto en tokens de distintos proveedores de LLM
- ¿Cómo se instala octopus?
- Ejecuta el contenedor de Docker: docker run -d --name octopus -v /path/to/data:/app/data -p 8080:8080 bestrui/octopus O descarga el binario desde la página de versiones y ejecútalo: ./octopus start
- ¿Dónde consigo octopus?
- El código fuente y las instrucciones de instalación están en GitHub: https://github.com/bestruirui/octopus
Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.
Proyectos relacionados
Gateway de API de código abierto que enruta solicitudes de LLM entre varios proveedores mediante una interfaz compatible con OpenAI, con gestión de claves y análisis de uso.
Gateway autohospedado que expone varios proveedores de LLM detrás de una única API compatible con OpenAI, con balanceo de carga.
Gateway de IA autoalojado que ofrece APIs compatibles con OpenAI, Claude y Gemini para muchos proveedores de modelos, con enrutamiento, claves, cuotas y seguimiento de costos.
Gateway de LLM autohospedado y compatible con OpenAI que dirige las solicitudes desde un único endpoint a más de 40 proveedores, con claves virtuales, presupuestos y seguimiento del uso.
Gateway de IA autohospedado que reúne API keys y cuentas de suscripción de varios proveedores en un único endpoint, con programación, failover y registros de uso.