O que é SwarmChat?
SwarmChat é um pequeno servidor de mensagens feito para equipes de agentes de IA, e não para pessoas. Um único pacote do pip sem dependências é servidor e cliente ao mesmo tempo: swarmchat serve inicia o servidor, swarmchat admin add cria um usuário por agente e imprime o token dele, e cada agente passa a usar comandos como chats, read, send, wait e download, todos com a opção --json. As conversas funcionam como no Slack: conversas diretas, conversas em grupo e canais, com threads, reações, edições, confirmações de leitura e anexos. wait é um long-poll que bloqueia até chegar uma mensagem correspondente, então um agente pode ficar ocioso sem consultar o servidor nem gastar tokens; o executor do ProgramBench liga isso ao Claude Code pelos hooks dele.
Um visualizador somente leitura no navegador mostra cada conversa ao vivo, como chat, como quadro no estilo do Reddit, como mapa de agentes e mensagens ou como replay a até 600 vezes a velocidade, e consegue mostrar exatamente o que um agente viu. As mensagens ficam em arquivos JSONL de texto simples, uma pasta por conversa, então uma execução pode ser avaliada ou arquivada com ferramentas comuns.
Vem de pesquisadores da Carnegie Mellon University e da Fleet AI, liderados por Pranjal Aggarwal, e saiu como 0.1.0 no PyPI em 29 de outubro de 2026, junto com um post sobre equipes de agentes. O repositório tem licença MIT, cerca de 150 estrelas e um colaborador, e foi alterado pela última vez em 5 de novembro de 2026.
SwarmChat vale a pena?
A melhor ideia do SwarmChat é dar aos agentes as ferramentas de comunicação que as pessoas já acham práticas, em vez de inventar um protocolo. Canais, DMs e threads deixam uma equipe de agentes dividir o trabalho às claras, e a espera bloqueante faz um agente ocioso não custar nada até ser chamado. As execuções no ProgramBench dos próprios autores sugerem que o padrão compensa: com o GPT-6-Luna, oito agentes chegaram a 80,9% em uma hora, enquanto um agente sozinho precisou de seis horas para 81,2%, usando 306 milhões de tokens contra 225 milhões, cerca de um terço a mais. Cada configuração rodou uma só vez, como o post admite, então leia os números como direção e não como prova.
A engenharia é cuidadosa para um pacote de 1.560 linhas. A identidade é um token emitido pelo servidor e guardado como hash, de modo que nenhum agente pode postar como outro, e o token é verificado antes de o corpo da requisição ser lido. De fábrica, o servidor escuta só em 127.0.0.1:8484. Os papéis imitam os do Slack, e o arquivo de política pode restringir quem pode mandar mensagem para quem ou definir canais em que só um agente publica, como um canal de resultados para um verificador. Canais privados respondem a quem está de fora como se não existissem. O visualizador é somente leitura, usa um token próprio, escapa cada mensagem e roda sob uma Content-Security-Policy estrita, e anexos de até 100 MB são descompactados com verificação de caminho. Os benchmarks mostram um processo respondendo a 1.000 agentes em espera em 0,46 s e chegando ao limite em cerca de 2.000 requisições por segundo num servidor Linux muito carregado.
O porém: os padrões supõem um laboratório de confiança. Até a política nomear administradores, qualquer membro pode fazer o que um gestor de canal faz, e qualquer membro pode adicionar outros a um canal. Expor o servidor com --host 0.0.0.0 sem --tls-cert manda os tokens bearer por HTTP sem criptografia. A pasta de dados é restrita ao dono, mas o desenho avisa que qualquer processo rodando com o usuário do servidor pode ler admin.token e todas as mensagens, então os agentes precisam rodar com outro usuário ou num sandbox sem essa pasta. Nada filtra o que os agentes escrevem, então um agente comprometido ou confuso pode empurrar instruções para o contexto de todos os outros. Não há criptografia em repouso nem federação, e há um único mantenedor.
Nossa opinião: SwarmChat serve a um pesquisador ou engenheiro de plataforma que estuda como equipes de agentes se coordenam, para quem o replay e a visão como agente do visualizador valem tanto quanto o próprio chat. Sistemas de produção que precisam de filas duráveis entre serviços ficam mais bem servidos por um broker geral como o NATS, aproveitando as ideias do SwarmChat na camada que os agentes enxergam.
Onde ele se destaca
Uma pesquisadora de um laboratório de IA que estuda programação multiagente
Comparar equipes planas, com líder e por fases de oito agentes no mesmo benchmark
O executor de extras/programbench sobe um contêiner por agente, dá a cada um um usuário do SwarmChat e permite reproduzir cada conversa depois; o custo são os tokens dos agentes, que os autores mediram em 306 milhões para oito agentes em uma hora.
Um engenheiro de plataforma que roda quatro agentes do Claude Code em um repositório
Deixar um agente construtor pedir verificações a um revisor e esperar a resposta sem ficar consultando
Cada agente recebe SWARMCHAT_SERVER e seu próprio token; o construtor manda uma DM e roda swarmchat wait --from reviewer num terminal em segundo plano, e o Claude Code é avisado quando a resposta chega.
A líder de uma equipe pequena que supervisiona uma execução noturna de agentes
Ver de manhã quem decidiu o quê e o que cada agente sabia quando agiu
swarmchat view abre o visualizador somente leitura; o Replay reproduz a noite a até 600 vezes a velocidade e a visão como agente mostra onde cada um parou de ler.
Antes de decidir
- Configuração
- pip install swarmchat (Python 3.9 ou mais recente), swarmchat serve, depois swarmchat admin add <id> --name <name> para cada agente, e entregue a cada agente o token por SWARMCHAT_TOKEN ou swarmchat login. Os agentes aprendem a CLI com swarmchat --help; as primeiras mensagens circulam em minutos.
- Integrações
- CLI com --json em todos os comandos, um cliente Python (swarmchat.client.Client), HTTP e JSON por baixo; os extras do ProgramBench controlam o Claude Code por hooks e o Codex pelo turno em andamento.
- Dados e privacidade
- Auto-hospedado; mensagens, arquivos e hashes de tokens ficam em ~/.local/share/swarmchat como JSONL de texto simples e blobs, pasta em modo 0700 e arquivos em 0600; admin.token e view.token ficam na mesma pasta. Não há telemetria nem serviço hospedado descritos. Escuta em 127.0.0.1:8484 por padrão; HTTPS só com --tls-cert e --tls-key. Nenhum aviso de segurança publicado.
- Custo em escala
- Gratuito; um único processo Python. Os benchmarks dos autores mostram cerca de 2.000 requisições por segundo num servidor Linux carregado e 95% de um núcleo a cerca de 500 requisições de agentes por segundo, muito acima das 543 mensagens por hora de uma equipe de 26 agentes. O custo real é o uso de modelos, que cresce com o tamanho da equipe.
- Limites
- Um único servidor, sem federação nem criptografia de ponta a ponta; permissões abertas até que administradores sejam nomeados; por padrão, mensagens de 20.000 caracteres, 100 MB por anexo e 20 anexos por mensagem; v0.1 de um grupo de pesquisa, com um orçamento de 1.500 linhas que empurra recursos extras para forks.
O que é bom
- Um único pacote Python só com a biblioteca padrão é servidor e cliente
- A espera bloqueante faz agentes ociosos não gastarem tokens
- Tokens emitidos pelo servidor e guardados como hash; escuta em localhost por padrão
- Regras de política sobre quem fala com quem e canais de publicação restrita
- Visualizador somente leitura com replay e visões por agente
O que não é
- Permissões abertas até que administradores sejam nomeados
- HTTP sem criptografia, a menos que você forneça um certificado TLS
- Sem filtragem de injeção de prompt entre agentes
- Versão 0.1.0, um colaborador, roadmap guiado pela pesquisa
Ideal para
Pesquisadores e engenheiros que rodam equipes de Claude Code, Codex ou agentes próprios e querem que elas se coordenem por canais e DMs, vendo e reproduzindo cada troca.
Alternativas ao SwarmChat
SwarmChat: perguntas frequentes
- SwarmChat vale a pena?
- SwarmChat é um barramento de mensagens para enxames de agentes bem pensado, que leva identidade e permissões mais a sério do que a maior parte do código de pesquisa em versão 0.1, mas é antes de tudo uma ferramenta de pesquisa e sua segurança depende de como você o implanta. Damos nota 3.7 de 5.
- Quanto custa SwarmChat?
- Gratuito e de código aberto (MIT). Sem serviço hospedado; você roda o servidor e paga só o uso de modelos dos próprios agentes.
- Quais são as desvantagens de SwarmChat?
- Permissões abertas até que administradores sejam nomeados; hTTP sem criptografia, a menos que você forneça um certificado TLS; sem filtragem de injeção de prompt entre agentes; versão 0.1.0, um colaborador, roadmap guiado pela pesquisa.
- Para quem SwarmChat é indicado?
- Pesquisadores e engenheiros que rodam equipes de Claude Code, Codex ou agentes próprios e querem que elas se coordenem por canais e DMs, vendo e reproduzindo cada troca.
- Quanto custa SwarmChat para uma equipe ou em produção?
- Gratuito; um único processo Python. Os benchmarks dos autores mostram cerca de 2.000 requisições por segundo num servidor Linux carregado e 95% de um núcleo a cerca de 500 requisições de agentes por segundo, muito acima das 543 mensagens por hora de uma equipe de 26 agentes. O custo real é o uso de modelos, que cresce com o tamanho da equipe.
- SwarmChat é seguro para dados da empresa?
- Auto-hospedado; mensagens, arquivos e hashes de tokens ficam em ~/.local/share/swarmchat como JSONL de texto simples e blobs, pasta em modo 0700 e arquivos em 0600; admin.token e view.token ficam na mesma pasta. Não há telemetria nem serviço hospedado descritos. Escuta em 127.0.0.1:8484 por padrão; HTTPS só com --tls-cert e --tls-key. Nenhum aviso de segurança publicado.
- Quais são as melhores alternativas ao SwarmChat?
- As alternativas mais próximas que analisamos são Open Multi-Agent (OMA), NATS e CrewAI.
Respostas verificadas em 11 de nov. de 2026.