IA local y RAG
Asistente de IA autoalojado con Octop: tus agentes en tu máquina, con Ollama y Claude Code
Octop es un asistente open source (MIT) de Tencent Cloud que corre en tu equipo: panel web, CLI, Telegram o Discord y tareas programadas. Cada usuario tiene varios agentes, puede usar modelos de Ollama y pasar el código a Claude Code, Codex u OpenCode. No probado por Fluye.
| Herramientas | Ollama (principal)Claude CodeCursor |
|---|---|
| Qué necesitas |
|
| Coste aprox. | Octop es gratis y open source (MIT). Con modelos de Ollama no pagas API; si usas un proveedor en la nube o Claude Code, va con tu plan. |
| Tiempo de montaje | 30 min (primera vez), aprox., estimación propia |
| Nivel | Media |
| Plan gratis | Puede bastar para pruebas |
Prompt listo para usar
Eres mi asistente en Octop. Tarea: [TAREA] en la carpeta [CARPETA]. 1. Investiga primero con el navegador o la terminal y resúmeme en cinco líneas qué hay que hacer. 2. La parte de código pásala con acp_runner a [AGENTE_DE_CODIGO], con un encargo corto y un criterio para dar por buena la tarea. 3. Si te pide permiso para algo, enséñame la opción exacta antes de responder. 4. Al final, dime qué cambió, qué comprobaste y qué falta. No cierres la sesión del agente hasta que yo lo diga.
| Variable | Qué poner | Ejemplo |
|---|---|---|
[TAREA] | Lo que quieres conseguir | añadir un formulario de reservas a la web del restaurante |
[CARPETA] | Ruta del proyecto en la máquina donde corre Octop | ~/proyectos/web-restaurante |
[AGENTE_DE_CODIGO] | Runner de ACP que tengas activado | claude_code |
Pégalo en: Claude Code, Cursor
Prompt propio de Fluye basado en la herramienta acp_runner que documenta Octop. No lo hemos ejecutado aquí.
Cómo funciona
- Instala e inicializa. pip install octop y después octop init: el asistente crea la base de datos, el secreto y la primera cuenta de administrador en ~/.octop/.
- Arranca el panel. octop run y abre http://127.0.0.1:8088. Con octop service start se queda como servicio del sistema.
- Elige el modelo. Configura el proveedor por agente desde el panel o con octop provider. Admite Ollama, APIs compatibles con OpenAI y otros.
- Crea agentes y usuarios. Cada persona entra con su cuenta y tiene varios agentes, cada uno con su espacio de trabajo, proveedor, canales y tareas programadas.
- Delega el código. En la sección ACP del panel activa un runner (Claude Code, Codex, OpenCode, Cursor CLI y otros) y enciende la herramienta acp_runner en el agente. Luego pídele en el chat que la use.
- Conecta tus canales. Telegram, Discord y otras apps de mensajería, más tareas programadas en lenguaje natural para que el agente te avise o ejecute cosas a su hora.
Qué resultado esperar
Un asistente que vive en tu equipo, con tus conversaciones y credenciales en local, varios agentes por persona y el código delegado al agente que ya usas.
- Qué se hizo
- Tencent Cloud publicó un asistente autoalojado en el que cada usuario tiene varios agentes con navegador, terminal y memoria, y que pasa el trabajo de código a agentes externos.
- Cómo fue
- El repo pasa de 11K estrellas en GitHub (3 nov 2026) y se actualiza a diario. No publica resultados medidos.
- A tener en cuenta
- Mucha superficie (terminal, escritorio remoto, mensajería): conviene empezar en local y con permisos mínimos. Sin prueba propia todavía.
Límites y precauciones
- Es una herramienta, no un caso con resultados: la fuente no publica cifras de uso ni de ahorro.
- Los modelos locales de Ollama rinden menos que los grandes de pago en tareas largas; depende de tu equipo.
- Varias funciones (equipos de agentes) están en beta según el README.
- Sin prueba propia todavía.
- Si arrancas con --host 0.0.0.0 el panel queda expuesto a tu red: ponlo detrás de una contraseña fuerte o no lo abras fuera de casa.
- La terminal, el navegador y el escritorio remoto dan mucho poder al agente. Usa la aprobación de herramientas que trae y empieza con permisos mínimos.
- Delegar a Claude Code o Codex sigue gastando de tu plan, aunque Octop corra en local.
Variantes
- claude-code: Runner integrado vía npx @zed-industries/claude-agent-acp. Octop también funciona al revés: octop acp deja que un IDE como Zed use tu agente de Octop.
- cursor: Runner cursor_cli (comando agent acp) si tienes la CLI de Cursor instalada.
Fuentes: repo Octop en GitHub y su documentación de ACP. Caso curado, no probado por Fluye.
Tienes Claude Code para programar, Ollama para un modelo local y un bot de Telegram a medias. Octop junta las piezas en un solo proceso que corre en tu equipo: panel web, línea de comandos, mensajería y tareas programadas, con todo guardado en ~/.octop/. Lo publica Tencent Cloud con licencia MIT.
Cada persona entra con su cuenta y tiene varios agentes, cada uno con su espacio, su modelo y sus canales. Puedes tener uno con un modelo de Ollama para notas e informes y otro que investiga con el navegador. Cuando toca escribir código, el agente se lo pasa por ACP a Claude Code, Codex, OpenCode o Cursor CLI, y te pide permiso cuando el agente de código lo necesita.
Lo bueno es la privacidad: conversaciones y credenciales en tu máquina. Lo que hay que vigilar es el poder que le das, porque trae terminal, navegador y escritorio remoto. Empieza en local y con permisos mínimos, y activa la aprobación de herramientas que trae. Ten en cuenta que delegar a Claude Code o Codex sigue gastando de tu plan aunque Octop corra en tu máquina, y que los equipos de agentes están en beta. Si solo quieres un modelo en tu equipo, mira modelo de IA local con Ollama. Para coordinar varios agentes de código, varios agentes sin pisarse. Ficha de la herramienta: Ollama.
Preguntas frecuentes
¿Lo habéis probado?
No. La ficha resume el README y la documentación de ACP del repo oficial. No lo hemos instalado.
¿Funciona sin internet?
Con un modelo de Ollama el razonamiento se queda en tu equipo. Si delegas a Claude Code o Codex, esas llamadas sí salen a su nube.
¿Es gratis?
Sí, licencia MIT. Pagas solo el modelo que elijas si no es local.
¿En qué se diferencia de un asistente con Claude Code?
Claude Code es el agente que programa. Octop es la capa de encima: usuarios, varios agentes, canales de chat y tareas programadas, y puede usar Claude Code como ayudante.
Telegram. Suscríbete al canal de Telegram para no perderte nada y estar al loro de todo lo nuevo en automatización y agentes de IA.Unirme al canal