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.