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.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/mininglamp-ossocto-server.svg)](https://yunodb.com/tools/mininglamp-ossocto-server?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/mininglamp-ossocto-server?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/mininglamp-ossocto-server.svg" alt="Featured on YunoDB" height="20"></a>