agent-squad

Flexible and powerful framework for managing multiple AI agents and handling complex conversations

What is agent-squad?

Flexible and powerful framework for managing multiple AI agents and handling complex conversations

Overview of agent-squad

What it is

Agent Squad is a flexible, lightweight open-source framework for orchestrating multiple AI agents. It routes each user query to the most suitable specialized agent and maintains conversation context across agents. The framework is available in three runtimes: Python (3.11+), TypeScript (Node.js), and Swift (iOS 16+ / macOS 14+). The Swift runtime runs entirely on device.

Key features

  • Intelligent intent classification — route queries by context and content.
  • Streaming and non-streaming agent responses.
  • Context management — coherent conversations across agents and sessions.
  • Extensible by design — custom agents, classifiers, storage, and retrievers.
  • Pre-built agents — Bedrock, Anthropic, OpenAI, Lex, Lambda, and more.
  • JevClassifier — typed decision routing with calibrated confidence, sub-second decisions, available in TypeScript and Python.
  • SupervisorAgent — team coordination with parallel sub-agent queries and shared context.
  • GroundedAgent — anti-hallucination pattern using two LLMs (gatherer and presenter) to prevent drift from data.
  • Swift runtime — on-device orchestration with agents, MCP tools, realtime voice, tracing, and local-first chat storage.

Use cases

  • Managing multiple AI agents and handling complex conversations.
  • On-device agent orchestration for iPhone, iPad, and Mac.
  • Team coordination where a lead agent delegates subtasks to specialized agents.
  • Scenarios requiring answers that exactly match data (e.g., prices, balances, availability).

Getting started

npm install agent-squad
pip install "agent-squad[aws]"
### Swift: add package dependency in Package.swift
### .package(url: "https://github.com/2FastLabs/agent-squad", branch: "main")

See the repository README for full quick-start examples in TypeScript, Python, and Swift.

License and pricing

Apache-2.0 license. Open source.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/2fastlabsagent-squad.svg)](https://yunodb.com/tools/2fastlabsagent-squad?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/2fastlabsagent-squad?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/2fastlabsagent-squad.svg" alt="Featured on YunoDB" height="20"></a>