Octop asistente IA autoalojado: instalar y proteger

Octop asistente IA autoalojado de TencentCloud: instalación según el README, interfaz, datos, permisos de los agentes y observabilidad con Langfuse.
Octop assistant IA auto-hébergé : installer et sécuriser

Octop asistente IA autoalojado: así se presenta el repositorio TencentCloud/Octop, con «multiusuario, multiagente» como subtítulo. Funciona en un único proceso que sirve un dashboard web, una línea de comandos, canales de mensajería (Feishu, DingTalk, QQ, WeChat, Telegram, Discord, WeCom) y tareas programadas. El repositorio cuenta con unas 10 700 estrellas a finales de octubre de 2026.

Para un equipo de operaciones, la pregunta no es «¿es bonito?», sino «¿adónde van mis datos, quién tiene qué permisos y qué pasa si lo expongo en la red?». Este artículo sigue el README y la documentación del repositorio. Cubre la instalación, el recorrido por la interfaz, los límites y la observabilidad. Complementa nuestro artículo sobre OpenClaw, otro asistente autoalojado.

Una precisión de honestidad: span.observer no ha instalado ni ejecutado Octop para este artículo. Los comandos proceden del README y las capturas proceden del repositorio del proyecto.

Octop asistente IA autoalojado: qué dice el repositorio

  • Editor y licencia: el repositorio se publica bajo la organización TencentCloud, licencia MIT (el archivo LICENSE lleva la mención «Copyright (c) 2026 Octop»).
  • Técnica: Python 3.12 o superior, FastAPI y uvicorn, interfaz React; base de control SQLite por defecto, PostgreSQL opcional.
  • Cifras revisadas el 22 de octubre de 2026: unas 10 700 estrellas, unos 1 400 forks, 844 commits. La página del repositorio no muestra ninguna release publicada; el badge del README indica la versión 1.0.2, y el paquete se publica en PyPI con el nombre octop.
  • Funciones anunciadas: expertos (agentes) por usuario, equipos de agentes en beta (AgentTeams), conectores OAuth y MCP, base de conocimiento (RAG), plugins, escritorio remoto, navegador controlado, cliente de escritorio, y ACP para delegar en OpenCode o Claude Code.

El proyecto es «local primero» según su README: configuración, conversaciones, espacios de trabajo y credenciales viven bajo ~/.octop/. El README anuncia también una hoja de ruta (agentes gestionados, marketplace de plugins) que debe leerse como orientativa, como él mismo dice.

Recorrido por la interfaz

El README muestra un dashboard web abierto en http://127.0.0.1:8088. La captura de abajo procede del repositorio (carpeta docs/assets); la interfaz está en chino y muestra la versión v0.9.8, más antigua que el badge 1.0.2 del README.

Captura del repositorio Octop: dashboard web en chino, menú lateral con chat, expertos, tareas, conectores, contador de tokens, canales y escritorio remoto, y zona de entrada del chat
Source : github.com

En el menú de la izquierda se lee, entre otros, «Token 统计» (estadísticas de tokens), «终端 AI+» y «浏览器 AI+» (terminal y navegador asistidos), «远程桌面» (escritorio remoto) y, en la sección de gestión, un registro de auditoría.

Captura del repositorio Octop: página de expertos con plantillas de agentes, entre ellas un experto de sistema y un experto de clúster, marcadas como instaladas
Source : github.com

La página de expertos lista plantillas instalables. Cada experto tiene su espacio de trabajo, sus proveedores de modelos, sus canales y sus tareas cron, según el README.

Instalación paso a paso

Paso 1 — Elegir el método

El README propone un script de instalación de una línea (macOS, Linux, Windows), aplicaciones de escritorio descargables en la página de releases, pip install octop y Docker. El script descarga un entorno Python aislado con uv bajo ~/.octop/ y no altera el Python del sistema.

Punto de vigilancia: la dirección del script es un bucket de objetos de Tencent Cloud (dominio cos.ap-guangzhou.myqcloud.com), no el repositorio de GitHub. Ejecutar curl … | bash sin haberlo leído es una práctica arriesgada en un servidor. Lee el script, o prefiere pip en un entorno virtual, o Docker.

Paso 2 — Instalar, inicializar, arrancar

pip install octop
octop init
octop run

octop init crea la base SQLite, el secreto JWT y la primera cuenta de administrador bajo ~/.octop/; la contraseña debe tener al menos 8 caracteres con letras y cifras. octop run arranca la API y el dashboard en primer plano. Para un servicio del sistema: octop service start (systemd, launchd o servicio de Windows).

Paso 3 — Docker, la vía «producción» del README

docker compose -f docker/docker-compose.yml up -d
# o
docker run -d -p 8088:8088 -v octop-data:/data/.octop -e HOME=/data octop:latest

El README propone también un espejo para China (docker-compose.cn.yml) cuando ghcr.io es inaccesible. Sin OCTOP_DEFAULT_PASSWORD, no se crea ningún administrador: se termina el asistente de configuración con la contraseña de desbloqueo que se lee en /data/.octop/octop-login.txt.

Datos y permisos: qué conviene mirar

La documentación de configuración describe el árbol de directorios: config.json, octop.db (usuarios, agentes, proveedores, sesiones, auditoría), secrets/jwt_secret, agents/<id>/ (un espacio por agente), plugins/ y logs/. Los ajustes por defecto del archivo config.json incluyen bind_host en 127.0.0.1, login_max_attempts en 5, login_lockout_seconds en 900 y enable_api_docs en false.

Captura del repositorio Octop: página de ajustes de la aplicación con las pestañas variables de entorno, búsqueda con IA, voz, observabilidad, copia de seguridad y HTTPS
Source : github.com

Las pestañas de la página de ajustes incluyen «可观测» (observabilidad), la copia de seguridad y HTTPS. El archivo SECURITY.md del repositorio recuerda que el operador sigue siendo responsable de la seguridad del host, de la exposición de red, de la rotación de los secretos JWT, de las reglas de la barrera de seguridad bajo ~/.octop/security/tool_guard/ y de la protección de las claves de LLM y de las credenciales de los canales.

  • Adónde van los textos: «local primero» describe el almacenamiento. Una conversación enviada a un proveedor de modelos en línea sale de tu máquina; solo un modelo local (el README cita Ollama) mantiene todo en tu casa.
  • Exposición: la opción octop run --host 0.0.0.0 abre el puerto 8088 a toda la red. Pon un proxy TLS delante y limita las direcciones autorizadas.
  • Permisos de los agentes: el README cita el aislamiento por usuario (JWT), la aprobación de herramientas y reglas sobre comandos shell. Los agentes pueden además controlar un navegador o un escritorio: trátalos como una cuenta de operación.
  • Canales: cada canal de mensajería requiere un token de bot, que debe guardarse como un secreto.

Observar Octop

El código fuente muestra una integración de observabilidad con Langfuse: una ruta de administración lee y escribe la configuración (activada, host, clave pública, clave secreta), y se prevé una prueba de conexión. El formulario de la página de ajustes propone un host del tipo https://cloud.langfuse.com; se puede apuntar a una instancia autoalojada. Consulta Langfuse y OpenLLMetry para la observabilidad de LLM. El README no describe ninguna exportación OpenTelemetry nativa: si la necesitas, comprueba el código antes de prometerla a tus equipos.

  • Costes: el dashboard tiene una página de estadísticas de tokens. Para relacionar los costes con tus presupuestos, consulta el coste de un agente de IA en tokens.
  • Logs: ~/.octop/logs/ para el servicio, ~/.octop/octop.log en primer plano. Redirígelos a tu colector de logs habitual.
  • Procesos: en Linux, octop service start instala límites de memoria de systemd por defecto (MemoryHigh=60%, MemoryMax=75% de la RAM). Vigila los reinicios del servicio.
  • Auditoría: la interfaz ofrece un registro de auditoría; revísalo tras cada cambio de permisos.

Límites y puntos abiertos

  • La interfaz mostrada en el repositorio está en chino; la documentación y el README están en inglés.
  • Los equipos de agentes se anuncian en beta, la aplicación móvil en beta cerrada.
  • La página del repositorio no mostraba ninguna release en la fecha de revisión: fija la versión que instales (octop update instala la más reciente).
  • El script de instalación está alojado fuera de GitHub; compruébalo antes de ejecutarlo.
  • El README no describe ninguna recopilación de datos por parte del proyecto; vigila las conexiones salientes de tu instancia para salir de dudas.

Buenas prácticas

  • Empieza en local sobre 127.0.0.1, un solo usuario, con un modelo local o una cuenta de API dedicada y con tope.
  • Haz copia de seguridad con octop backup antes de cualquier actualización (el README lo pide antes de un cambio de versión mayor).
  • Mantén las claves de API y los tokens de canales fuera de los repositorios y de las trazas; consulta nuestra guía sobre las barreras de seguridad de los agentes de IA en producción.
  • Limita los conectores MCP a lo necesario (consulta cómo proteger un servidor MCP).

Preguntas frecuentes

¿Envía Octop mis datos a Tencent?

El README describe un funcionamiento local primero y no menciona ninguna recopilación. Tus textos van al proveedor de modelos que configures; el script de instalación está alojado por Tencent Cloud. Para estar seguro, vigila las conexiones salientes.

¿Hay que instalar Python?

No con el script de instalación, que aprovisiona Python 3.12 con uv. Con pip, hace falta tener ya Python 3.12 o superior.

¿Se puede usar sin modelo en línea?

El README lista Ollama entre los proveedores admitidos. La calidad depende entonces del modelo local elegido y de tu hardware.

Conclusión

Octop reúne muchas funciones en un único proceso, lo que simplifica la instalación y concentra el riesgo: una cuenta de administrador, agentes capaces de actuar y tokens de canales en el mismo sitio. El proyecto merece una prueba aislada, con los prudentes ajustes por defecto del README. Fuentes: repositorio TencentCloud/Octop.

span.observer es un blog independiente de la comunidad, no afiliado a Dynatrace LLC ni a Tencent ni a los proyectos citados. Las marcas citadas pertenecen a sus propietarios. Las herramientas evolucionan rápido: comprueba los comandos y las opciones en su documentación oficial.

Total
0
Shares
Leave a Reply

Your email address will not be published. Required fields are marked *

Previous Post
ECC optimisation harnais agents : skills, hooks et sécurité

ECC optimización arnés de agentes: skills, hooks y seguridad

Next Post
Impeccable langage design agents IA : installer et vérifier

Impeccable lenguaje de diseño para agentes de IA: instalar y verificar

Related Posts