Repolode
Kocoro-lab

Kocoro-lab/Shannon

Framework de orquestração multiagente em Go, Rust e Python para executar agentes de LLM em produção, com workflows do Temporal e limites de tokens.

Estrelas
2,320
Forks
361
Issues abertas
8
Último commit
há 2 meses

O que é?

Shannon é um framework de orquestração multiagente voltado à execução confiável de agentes de IA em produção. As tarefas podem ser enviadas por uma REST API, um endpoint compatível com OpenAI, um SDK de Python ou um app desktop e são encaminhadas, conforme sua complexidade, para uma entre várias estratégias de execução, como respostas simples de um único agente, fan-out/fan-in em DAG, loops ReAct, pesquisa, exploração por tree of thoughts e equipes de swarm.

O sistema executa workflows no Temporal para garantir tolerância a falhas e permite reproduzir execuções anteriores para depuração. É possível definir limites de tokens por tarefa, com fallback automático para modelos mais baratos conforme os limites se aproximam. A execução de código ocorre em um sandbox WASI, e pontos de aprovação humana opcionais podem pausar um workflow até que uma decisão seja enviada. Métricas e tracing usam Prometheus e OpenTelemetry.

Shannon oferece suporte a Anthropic, OpenAI, Google, DeepSeek, xAI, Groq e modelos locais via Ollama, LM Studio ou vLLM. A implantação é feita com Docker Compose, e o projeto inclui tarefas agendadas, continuidade de sessão e skills que podem ser definidas em YAML e Markdown.

Recursos principais

  • 01Várias estratégias de execução, selecionadas automaticamente conforme a complexidade da tarefa
  • 02Workflows do Temporal com reprodução de execuções anteriores para depuração
  • 03Limites de tokens por tarefa com fallback automático de modelo
  • 04Sandbox WASI para execução de código e pontos de aprovação humana opcionais
  • 05Endpoint de API compatível com OpenAI, SDK de Python e app desktop
  • 06Suporte a vários provedores de LLM, incluindo modelos locais via Ollama e vLLM

Casos de uso

  • Executar tarefas de pesquisa ou análise com várias etapas e limites de custo
  • Adicionar pontos de aprovação antes que agentes realizem ações sensíveis
  • Usar código existente com o SDK da OpenAI apontando para um backend de agentes autohospedado
  • Agendar tarefas recorrentes de agentes, como análises diárias do mercado

Início rápido

  1. 1

    Execute o script de instalação com um único comando do README (revise-o antes; ele é direcionado ao bash).

  2. 2

    Instale o SDK do Python.

    pip install shannon-sdk
  3. 3

    Envie sua primeira tarefa pela REST API.

    curl -X POST http://localhost:8080/api/v1/tasks -H "Content-Type: application/json" -d '{"query": "What is the capital of France?", "session_id": "demo"}'

Antes de usar

  • Requer Docker e Docker Compose, além de uma chave de API de pelo menos um provedor de LLM.
  • A instalação com um único comando executa um script remoto direcionado ao bash.
  • O serviço opcional de navegador do Playwright adiciona uma imagem de aproximadamente 3,4 GB.

Em coleções

Tópicos

Perguntas frequentes

O que é Shannon?
Framework de orquestração multiagente em Go, Rust e Python para executar agentes de LLM em produção, com workflows do Temporal e limites de tokens. Shannon é um framework de orquestração multiagente voltado à execução confiável de agentes de IA em produção. As tarefas podem ser enviadas por uma REST API, um endpoint compatível com OpenAI, um SDK de Python ou um app desktop e são encaminhadas, conforme sua complexidade, para uma entre várias estratégias de execução, como respostas simples de um único agente, fan-out/fan-in em DAG, loops ReAct, pesquisa, exploração por tree of thoughts e equipes de swarm.
Shannon é gratuito? Qual é a licença?
Shannon é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
Shannon ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de Shannon foi em 5 de set. de 2026.
Para que posso usar Shannon?
Executar tarefas de pesquisa ou análise com várias etapas e limites de custo Adicionar pontos de aprovação antes que agentes realizem ações sensíveis Usar código existente com o SDK da OpenAI apontando para um backend de agentes autohospedado Agendar tarefas recorrentes de agentes, como análises diárias do mercado
Como instalar Shannon?
Execute o script de instalação com um único comando do README (revise-o antes; ele é direcionado ao bash). Instale o SDK do Python.: pip install shannon-sdk Envie sua primeira tarefa pela REST API.: curl -X POST http://localhost:8080/api/v1/tasks -H "Content-Type: application/json" -d '{"query": "What is the capital of France?", "session_id": "demo"}'
Onde consigo Shannon?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/Kocoro-lab/Shannon

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados