Repolode
kyegomez

kyegomez/swarms

Framework Python para criar e orquestrar sistemas multiagente com fluxos de trabalho sequenciais, concorrentes, baseados em grafos e hierárquicos.

Estrelas
7,278
Forks
1,052
Issues abertas
429
Último commit
ontem

O que é?

Swarms é um framework Python para criar sistemas em que vários agentes com LLMs trabalham juntos em uma tarefa. Cada Agent encapsula um modelo com um prompt de sistema, ferramentas e memória opcional, e o framework oferece vários padrões de orquestração prontos para coordená-los, incluindo SequentialWorkflow, ConcurrentWorkflow, AgentRearrange, GraphWorkflow, MixtureOfAgents, HierarchicalSwarm e um SwarmRouter que seleciona entre eles.

Os agentes podem se conectar a ferramentas externas por meio de servidores MCP, definindo um mcp_url, e a classe MCPDeployer pode disponibilizar um agente ou swarm como servidor MCP com autenticação por chave de API, personalizada ou por token com escopo. O projeto também inclui skills de agentes definidas em arquivos SKILL.md e um AutoSwarmBuilder que gera agentes a partir da descrição de uma tarefa.

O pacote pode ser instalado com pip, uv ou poetry, e há uma imagem oficial do Docker disponível. Extras opcionais adicionam um gateway de modelos mais rápido e um backend de grafos baseado em Rust para o GraphWorkflow.

Recursos principais

  • 01Fluxos de trabalho multiagente sequenciais, concorrentes, em grafo (DAG) e hierárquicos.
  • 02SwarmRouter oferece uma interface única para executar diferentes tipos de swarm.
  • 03Os agentes se conectam a servidores MCP e também podem ser disponibilizados como servidores MCP.
  • 04Oferece suporte a skills de agentes definidas em arquivos SKILL.md.
  • 05Gera automaticamente agentes e fluxos de trabalho a partir da descrição de uma tarefa com o AutoSwarmBuilder.

Casos de uso

  • Criar um pipeline de pesquisa em que um agente reúne materiais e outro redige o resultado.
  • Executar vários agentes especialistas em paralelo na mesma tarefa de análise e combinar os resultados.
  • Disponibilizar um agente interno para outros hosts compatíveis com MCP, protegido por uma chave de API.
  • Prototipar rapidamente um sistema multiagente a partir da descrição de uma tarefa em linguagem natural.

Início rápido

  1. 1

    Instale o pacote com pip

    pip3 install -U swarms
  2. 2

    Defina a chave de API do seu provedor de modelos no ambiente

  3. 3

    Execute o primeiro exemplo de agente em Python

    python agent.py

Antes de usar

  • Os exemplos usam APIs de LLM hospedadas, então você precisa de uma chave de API de um provedor pago para executá-los.
  • O README descreve muitas arquiteturas, então a API é ampla e pode levar tempo para aprender a usá-la.

Tópicos

Perguntas frequentes

O que é swarms?
Framework Python para criar e orquestrar sistemas multiagente com fluxos de trabalho sequenciais, concorrentes, baseados em grafos e hierárquicos. Swarms é um framework Python para criar sistemas em que vários agentes com LLMs trabalham juntos em uma tarefa. Cada Agent encapsula um modelo com um prompt de sistema, ferramentas e memória opcional, e o framework oferece vários padrões de orquestração prontos para coordená-los, incluindo SequentialWorkflow, ConcurrentWorkflow, AgentRearrange, GraphWorkflow, MixtureOfAgents, HierarchicalSwarm e um SwarmRouter que seleciona entre eles.
swarms é gratuito? Qual é a licença?
swarms é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
swarms ainda é mantido?
Manutenção ativa. O último commit de swarms foi em 19 de out. de 2026.
Para que posso usar swarms?
Criar um pipeline de pesquisa em que um agente reúne materiais e outro redige o resultado. Executar vários agentes especialistas em paralelo na mesma tarefa de análise e combinar os resultados. Disponibilizar um agente interno para outros hosts compatíveis com MCP, protegido por uma chave de API. Prototipar rapidamente um sistema multiagente a partir da descrição de uma tarefa em linguagem natural.
Como instalar swarms?
Instale o pacote com pip: pip3 install -U swarms Defina a chave de API do seu provedor de modelos no ambiente Execute o primeiro exemplo de agente em Python: python agent.py
Onde consigo swarms?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/kyegomez/swarms

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

Projetos relacionados