octo-server
Backend Go central de OCTO, plataforma de oficina abierta para humanos × agentes IA. Expone APIs REST + WebSocket, orquesta Lobster (agentes OpenClaw) y controla WuKongIM para mensajería en tiempo real.
Ficha actualizada 24 sept 2026, 22:23 · upstream 24 sept 2026, 7:24 · release v1.20.0
Qué es octo-server
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
octo-server es el núcleo backend del ecosistema OCTO, construido en Go con arquitectura modular bien definida. Centraliza la lógica de negocio, orquestación de agentes Lobster (digital doubles con OpenClaw), y actúa como control plane para WuKongIM. Expone APIs REST + WebSocket consumidas por octo-web, octo-admin y otros servicios del ecosistema.
La plataforma sigue un enfoque local-first: los datos residen en el box del usuario, no en la nube. Los agentes Lobster manejan el pensamiento y ejecución, mientras los humanos se enfocan en el criterio (taste). Soporta almacenamiento pluggable (MySQL-compatible + adapters) y mensajería intercambiable.
La arquitectura incluye cmd/ para entry points, internal/api/ para handlers REST/WebSocket, internal/service/ para lógica de negocio, internal/repository/ para acceso a datos, internal/im/ para control plane de WuKongIM, y internal/agent/ para orquestación de Lobster.
- Orquestación de agentes IA (Lobster) para automatización de tareas empresariales
- Plataforma de mensajería en tiempo real con WuKongIM como control plane
- Backend centralizado para clientes web, Android e iOS del ecosistema OCTO
- Gestión de canales, usuarios y organizaciones con RBAC org-aware
- Integración con adaptadores de terceros vía octo-adapters
- Arquitectura modular con separación clara entre API, servicio, repositorio y control plane
- Orquestación nativa de agentes IA como ciudadanos de primera clase en conversaciones
- Soporte pluggable para almacenamiento SQL (MySQL-compatible) y object storage (S3/MinIO)
- Enfoque local-first: datos del usuario en su propio box, cloud opcional
- APIs unificadas REST + WebSocket con tracing y métricas integradas
- No incluye Docker Compose directamente; requiere usar octo-deployment oficial para stack completo
- Complejidad HIGH con múltiples dependencias: MySQL, Redis, MongoDB, MinIO, WuKongIM
- Dependencia externa de WuKongIM para el core de mensajería en tiempo real
- Configuración manual requerida sin soporte one-click (aunque hay OOTB deployment separado)
- Requiere 4 núcleos CPU y 4GB RAM mínimo según análisis técnico
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.
Usar octo-deployment oficial (Mininglamp-OSS/octo-deployment) para stack completo con Docker Compose. Requiere MySQL-compatible DB, Redis, MinIO/S3 y WuKongIM externo. Para build manual: `go build -o octo-server .` y ejecutar con --config ./configs/tsdd.yaml. Ver QUICKSTART.md para walkthrough end-to-end y BUILDING.md para notas de cross-repo.
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.