octo-server
π The Go backend powering OCTO β an open workplace built for humans Γ AI agents. REST & WebSocket APIs, Lobster (AI agent) orchestration, and WuKongIM real-tim
What is octo-server?
π The Go backend powering OCTO β an open workplace built for humans Γ AI agents. REST & WebSocket APIs, Lobster (AI agent) orchestration, and WuKongIM real-time messaging control plane.
Overview of octo-server
What it is
octo-server is the Go backend at the centre of the OCTO platform. It exposes REST and WebSocket APIs consumed by octo-web and octo-admin, orchestrates business logic and Lobster (AI agent) scheduling, and drives the WuKongIM IM core for real-time messaging.
Key features
- REST and WebSocket APIs for conversation, user, group, file, org, and webhook handling - Lobster (AI agent) orchestration with routing, session store, and tool-call execution - Pluggable storage and IM: MySQL-compatible SQL migrations, object-storage adapters, and WuKongIM control-plane boundary - Authentication (token/cookie/DH-sealed WebSocket), org-aware RBAC, per-channel ACL, agent-identity gating - Business logic execution with possible Lobster agent session spawning/resuming - IM message fan-out via WuKongIM and adapter triggers for external bridges - Unified JSON envelope (or WebSocket frame) response with tracing and metrics tags
Use cases
octo-server is used as the backend for the OCTO open workplace, which is built for humans and AI agents. It supports building chat applications, AI agent scheduling, real-time messaging, task management, and admin console operations.
Getting started
bash git clone https://github.com/Mininglamp-OSS/octo-server.git cd octo-server go build -o octo-server . ./octo-server --config ./configs/tsdd.yaml The default dev config expects a local WuKongIM instance and a MySQL-compatible database. See the bundled configs/tsdd.yaml template, QUICKSTART.md, and BUILDING.md for more details. For a one-command Docker Compose stack, use the official OOTB deployment at Mininglamp-OSS/octo-deployment.
License and pricing
Licensed under the Apache License 2.0. It is open source and free to use.
Based on the project's public README and repository metadata.