Mininglamp-OSS/octo-server

O que é?

Recursos principais

• 01APIs REST e WebSocket para conversas, usuários, grupos, arquivos e organizações.
• 02Orquestração de agentes Lobster, incluindo roteamento, sessões e execução de chamadas de ferramentas.
• 03Mensagens em tempo real por meio de um cliente de control plane do WuKongIM.
• 04RBAC com suporte a organizações, ACL por canal e controle de acesso baseado na identidade do agente.
• 05Migrações SQL compatíveis com MySQL, com adaptadores para Redis e armazenamento de objetos.

Casos de uso

• Executar um chat de ambiente de trabalho self-hosted em que agentes de IA participam junto com a equipe.
• Criar um backend de mensagens integrado ao WuKongIM para entrega em tempo real.
• Estudar como um servidor de mensagens instantâneas com suporte a agentes gerencia autenticação, permissões e distribuição de mensagens.

Início rápido

1. 1

   Clone o repositório

   git clone https://github.com/Mininglamp-OSS/octo-server.git
2. 2

   Acesse o diretório do projeto

   cd octo-server
3. 3

   Compile o binário

   go build -o octo-server .
4. 4

   Execute o servidor com a configuração incluída (é necessário ter uma instância local do WuKongIM e um banco de dados compatível com MySQL)

   ./octo-server --config ./configs/tsdd.yaml

Antes de usar

• !Para executar, é necessário ter uma instância separada do WuKongIM e um banco de dados compatível com MySQL.
• !A implantação de toda a stack é feita em outro repositório, octo-deployment.

Tópicos

Perguntas frequentes

O que é octo-server?

Backend em Go para o OCTO, um ambiente de trabalho aberto onde pessoas e agentes de IA colaboram, com APIs REST e WebSocket e mensagens em tempo real baseadas no WuKongIM. octo-server é o serviço de backend do OCTO, um ambiente de trabalho self-hosted onde pessoas e agentes de IA atuam nas mesmas conversas. Ele expõe APIs REST e WebSocket consumidas pelos clientes web, admin e mobile do OCTO e cuida da lógica de negócio, como controle de acesso, permissões por organização e regras de acesso por canal.

octo-server é gratuito? Qual é a licença?

octo-server é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.

octo-server ainda é mantido?

Manutenção ativa. O último commit de octo-server foi em 21 de out. de 2026.

Para que posso usar octo-server?

Executar um chat de ambiente de trabalho self-hosted em que agentes de IA participam junto com a equipe. Criar um backend de mensagens integrado ao WuKongIM para entrega em tempo real. Estudar como um servidor de mensagens instantâneas com suporte a agentes gerencia autenticação, permissões e distribuição de mensagens.

Como instalar octo-server?

Clone o repositório: git clone https://github.com/Mininglamp-OSS/octo-server.git Acesse o diretório do projeto: cd octo-server Compile o binário: go build -o octo-server . Execute o servidor com a configuração incluída (é necessário ter uma instância local do WuKongIM e um banco de dados compatível com MySQL): ./octo-server --config ./configs/tsdd.yaml

Onde consigo octo-server?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/Mininglamp-OSS/octo-server