Framework Python para criar agentes de IA como fluxos de dados compostáveis que podem falhar, retomar, repetir etapas com segurança e explicar cada passo.
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
Execute o script de instalação com um único comando do README (revise-o antes; ele é direcionado ao bash).
- 2
Instale o SDK do Python.
pip install shannon-sdk - 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
App desktop que reúne ferramentas de CLI de IA, como Claude Code, Codex e Gemini CLI, em um espaço de trabalho multiagente com execução paralela e orquestração.
O framework UFO³ da Microsoft coordena agentes de GUI em vários dispositivos, com decomposição de tarefas baseada em DAG, e inclui o UFO² como agente de desktop para Windows.
Framework TypeScript para criar agentes LLM stateful e de longa duração como grafos, com persistência, memória e participação humana no fluxo.
Framework Java para criar aplicações de IA com agentes, workflows e múltiplos agentes sobre o Spring AI.
Sistema multiagente baseado em Context Engineering, com editor visual para criar, testar e implantar fluxos de trabalho com agentes.