Swarm

Swarm needs Python 3.10+ and installs directly from the repository.

Create agents with instructions and tools, and let one agent's function return another agent to hand the conversation over.

Start a client, run with an agent and messages, and read the final response.

The README install route (HTTPS form).

pip install git+https://github.com/openai/swarm.git

The README example: agent A hands off to agent B.

from swarm import Swarm, Agent
client = Swarm()
def transfer_to_agent_b():
    return agent_b
agent_a = Agent(name="Agent A", instructions="You are a helpful agent.", functions=[transfer_to_agent_b])
agent_b = Agent(name="Agent B", instructions="Only speak in Haikus.")

The README run call for the handoff example.

response = client.run(agent=agent_a, messages=[{"role": "user", "content": "I want to talk to agent B."}])
print(response.messages[-1]["content"])