AgentTeams
An open-source Collaborative Multi-Agent OS for transparent, human-in-the-loop task coordination via Matrix rooms.
AgentTeams is an open-source collaborative multi-agent operating system that orchestrates multiple AI agents through a Manager-Workers architecture on top of Matrix chat rooms. It enables teams of AI agents—running OpenClaw, QwenPaw, or Hermes runtimes—to collaborate on tasks with full human visibility and intervention via a self-hosted Matrix server. The platform centralizes credentials in a Higress AI Gateway so Workers operate with consumer tokens only, while MinIO provides shared file storage to reduce token costs. Developers can create, assign, and monitor AI Workers conversationally through any Matrix client, with every agent action visible and intervenable in real time.
Key Features
Use Cases
- 01Software development teams where multiple specialized AI agents collaborate on frontend, backend, and testing tasks
- 02Enterprise environments requiring auditable AI agent workflows with full human oversight and credential security
- 03Long-running research or content projects where agents share files and maintain persistent collaboration context
- 04Incident response scenarios with transparent multi-agent coordination and human intervention capabilities
- 05Autonomous coding workflows combining deterministic task orchestration agents with Hermes autonomous execution agents
- 06Private AI deployment where all agent communications and data remain on self-hosted infrastructure
Related Agents
View morehermes-agent
The agent that grows with you
agency-agents
A complete AI agency at your fingertips - From frontend wizards to Reddit community ninjas, from whimsy injectors to reality checkers. Each agent is a specialized expert with personality, processes, and proven deliverables.
openinterpreter
A coding agent for open models like Kimi K3
cline
Autonomous coding agent as an SDK, IDE extension, or CLI assistant.
AgentTeams — FAQ
What is AgentTeams?+
AgentTeams is an open-source multi-agent operating system that coordinates AI agents (Workers) through a Manager agent using Matrix chat rooms for transparent, human-in-the-loop collaboration. It supports OpenClaw, QwenPaw, and Hermes agent runtimes working together on shared tasks.
How do I install AgentTeams locally?+
Run the one-command installer script (bash <(curl -sSL https://raw.githubusercontent.com/agentscope-ai/AgentTeams/main/install/agentteams-install.sh) on macOS/Linux or the PowerShell equivalent on Windows). The installer sets up Docker containers for the Manager, Matrix server, AI gateway, file storage, and Element Web client, then guides you through LLM provider configuration.
What are the prerequisites and API key requirements?+
You need Docker Desktop (Windows/macOS) or Docker Engine (Linux) with 2 CPU cores and 4 GB RAM minimum. An LLM API key is required (OpenAI, Qwen, or any OpenAI-compatible provider). For Kubernetes deployment, you need Kubernetes 1.24+, Helm 3.7+, and a default StorageClass.
Which clients work with AgentTeams?+
Any Matrix protocol client works, including the bundled Element Web (accessed via browser at http://127.0.0.1:18088 after local install), Element mobile apps, and FluffyChat. All clients connect to your self-hosted Tuwunel Matrix server.
Is AgentTeams free and open source?+
Yes, AgentTeams is released under the Apache License 2.0 and is completely free to use. You only pay for your LLM provider API usage (OpenAI, Qwen, etc.).
How does AgentTeams handle API credentials securely?+
Real API keys and credentials are stored only in the Higress AI Gateway. Worker agents operate with consumer tokens and never see actual credentials, preventing exposure even if a Worker is compromised or code is injected.
How do I install AgentTeams?+
Open the source repository on GitHub and follow its README. AgentTeams is a agent — MCP Agents Market links you directly to the official repo.
Is AgentTeams free?+
AgentTeams is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.