Repolode
bestruirui

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. 1

    Ejecuta el contenedor de Docker

    docker run -d --name octopus -v /path/to/data:/app/data -p 8080:8080 bestrui/octopus
  2. 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