agent-swarm

Um mecanismo para tornar sua empresa AI Native
_{Construído por desplega.sh.}

[!TIP] Este repositório evolui todos os dias. Assista agora →

_{▸ cada equipe, um enxame · evolução diária · slack → pr · Making of}

agent-swarm.dev é um sistema operacional de código aberto para trabalho com IA. Um agente líder delega objetivos a trabalhadores como Claude Code ou Codex. Contêineres isolados, memória compartilhada, ferramentas, agendamentos e portões de revisão preservam o trabalho entre sessões.

O que você obtém

• Um agente líder que recebe trabalho do Slack, repositórios, rastreadores de issues, e-mail ou da API
• Resultados de tarefas validados por esquema para chamadores que precisam de saída JSON estruturada
• Tarefas adiadas que despertam quando todas ou algumas tarefas monitoradas atingem um resultado, ou quando um prazo chega
• Imagens inline de resultados de ferramentas nos logs de tarefas, com pré-visualizações que abrem em tamanho total
• Anexos de arquivos no painel por colar, arrastar e soltar, ou seletor de arquivos
• Trabalhadores em contêineres Docker isolados com ambientes de desenvolvimento
• Memória e identidade que persistem entre sessões, com classificações de citação e dicas de autoavaliação habilitadas por padrão
• Fluxos de trabalho, agendamentos, scripts e aplicativos para trabalho recorrente
• Extensões para hooks TypeScript confiáveis, instaladas como rascunhos inertes de propriedade do agente e ativadas por um líder, operador ou usuário do painel confiável
• Salas em tempo real para estado de página compartilhado, presença e canais ao vivo
• Sua escolha de harness e modelos: Claude Code, Codex, pi, opencode, Devin ou agentes ACP

flowchart LR
    subgraph IN["Tasks come in"]
        direction TB
        S["Slack"]
        G["GitHub / GitLab"]
        E["Email"]
        A["API / CLI"]
    end

    LEAD(["Lead Agent<br/>plans &amp; delegates"])

    subgraph WORKERS["Workers in Docker"]
        direction TB
        W1["Worker"]
        W2["Worker"]
        W3["Worker"]
    end

    subgraph BRAIN["Persistent brain"]
        direction TB
        MEM["Memory<br/>(vector search)"]
        ID["Identity<br/>(SOUL, CLAUDE.md)"]
    end

    subgraph OUT["Work ships"]
        direction TB
        PR["Pull Requests"]
        REPLY["Slack replies"]
        EMAIL["Email replies"]
    end

    IN --> LEAD --> WORKERS
    WORKERS -->|reads context| BRAIN
    WORKERS -->|writes learnings| BRAIN
    WORKERS --> OUT

Início Rápido

Dê ao seu agente de codificação a habilidade de operador para Docker Compose ou Kubernetes:

npx skills add desplega-ai/agent-swarm

Ou instale-o como um plugin no seu harness:

Harness	Comando
Claude Code	/plugin marketplace add desplega-ai/agent-swarm e depois /plugin install agent-swarm@agent-swarm
Codex	codex plugin marketplace add desplega-ai/agent-swarm && codex plugin add agent-swarm@agent-swarm (ou use npx skills acima)
Cursor	/add-plugin desplega-ai/agent-swarm
Gemini CLI	gemini extensions install https://github.com/desplega-ai/agent-swarm
Antigravity / Factory Droid	droid plugin marketplace add https://github.com/desplega-ai/agent-swarm e depois droid plugin install agent-swarm@agent-swarm
OpenCode, pi, Devin, Kimi, outros	npx skills add desplega-ai/agent-swarm

Os links de privacidade e termos do plugin descrevem o site do Agent Swarm e o serviço Cloud. O software auto-hospedado permanece coberto pela Licença MIT.

Ou use os exemplos diretamente:

git clone https://github.com/desplega-ai/agent-swarm.git && cd agent-swarm
cp .env.docker.example .env  # Set API_KEY, a harness credential, and all eight agent UUIDs.
openssl rand -base64 32 > encryption_key
chmod 600 .env encryption_key
docker compose -f docker-compose.example.yml --env-file .env up -d

Leia a lista de verificação do Compose antes de começar. API: http://localhost:3013, com /docs e /openapi.json. Painel: conecte-o à sua API. Kubernetes: instale o gráfico OCI Helm.

Integrações

Slack · GitHub · GitLab · Linear · Jira · AgentMail · WhatsApp (Kapso) · Composio · Sentry · Devin · Pesquisa Serply. Guias de integração.

O AgentMail arquiva entregas verificadas recebidas antes de reconhecê-las e retém o arquivo por 30 dias, incluindo e-mails excluídos do roteamento de tarefas. Consulte o runbook de triagem da caixa de entrada de contato para retenção, limites de cobertura e instruções de implantação.

Saiba mais

• Começando · Arquitetura · Playbooks · CLI · Referência da API
• Modelos de agentes
• Ajuda: contact@desplega.sh · Discord

Contribuindo

Leia CONTRIBUTING.md, faça um fork do repositório, crie uma branch e abra um PR. Discuta ideias no Discord.

Você é um agente? Execute npx skills add desplega-ai/agent-swarm ou leia a habilidade de operador.

Histórico de Estrelas

Licença

MIT · 2025-2026 desplega.sh

Padrões de recursos

Novas implantações habilitam o renderizador de threads do Slack v2, direcionamento enfileirado do Slack para o líder, direcionamento de tarefas, trabalhadores multi-runtime, RBAC e pré-carregamento de ferramentas de tarefas. Pesquisa de memória híbrida e expansão de grafo também estão habilitadas. Substituições explícitas de ambiente/configuração permanecem suportadas; consulte a referência de ambiente. Ao atualizar trabalhadores mais antigos, mantenha MULTI_RUNTIME_ENABLED=false até que eles suportem identidades de runtime. A renderização de delegação do Slack permanece opcional, e a retenção do banco de dados continua com padrão de execução simulada (dry-run).