massgen/MassGen
๐ MassGen is an open-source multi-agent scaling system that runs in your terminal, autonomously orchestrating frontier models and agents to collaborate, reason, and produce high-quality results. | Join us on Discord: discord.massgen.ai
1,102 โ
170 forksPythonUpdated 1mo ago
What you need to know
A Python multi-agent scaling framework for GenAI that runs several frontier-model agents (Claude, Gemini, GPT, Grok, etc.) in parallel on the same task, has them critique and refine each other's work, and picks the best answer by consensus voting. Not an MCP server itself, but can consume MCP servers as tools and also ships an OpenAI-compatible HTTP server.
Install
pip install massgen uv pip install massgen uv run massgen --setup (configures API keys, Docker, skills)
Usage
- โขInteractive multi-agent mode: `uv run massgen` or `uv run massgen "your question"`
- โขMulti-agent run with a config: `massgen --config @examples/basic/multi/three_agents_default "question"`
- โขMCP tools are configured per-agent via YAML `mcp_servers` (type `stdio` or `streamable-http`, with `allowed_tools`/`exclude_tools` filters)
- โขServe as an OpenAI-compatible API: `massgen serve` (default 0.0.0.0:4000, POST /v1/chat/completions with SSE streaming)
Key features
- โMulti-agent consensus: parallel processing, intelligence sharing, voting, convergence detection
- โ15+ model backends (OpenAI GPT-5.x, Claude, Gemini, Grok, Cerebras, Together, Groq, OpenRouter, Kimi, Qwen, Zhipu, local vLLM/SGLang/LM Studio, Claude Code, Codex, Copilot, Antigravity)
- โMCP integration: stdio and streamable-http servers, tool whitelist/blacklist, recursive MCP execution
- โTextual TUI with timeline, agent cards and vote tracking (Web UI and Rich display also available)
- โv0.1.97 app-layer permission engine (allow/ask/deny rules, hardline blocklist, audit ledger) plus OS-level sandbox; automation mode with status.json; massgen serve OpenAI-compatible endpoint
Best for
Developers who want coordinated multi-agent (multi-model) research, planning, and coding tasks with consensus-based quality control.
Caveats
- โ Early stage: README warns to expect breaking architecture changes as the system is in active development
- โ Agents can autonomously read/write/modify/delete files in permitted directories โ README gives explicit safety warnings and recommends isolated directories and backups
- โ Requires API keys for hosted models (OpenAI/Anthropic/Google/xAI etc.) unless using local backends
- โ Codex models are noted as suboptimal for MassGen coordination prompts (optimized for shorter system messages)
- โ Web automation use case marked 'still in test'; requires npm install @playwright/mcp@latest
Platforms: Windows ยท macOS ยท LinuxClients: Claude Code ยท Cursor ยท GitHub Copilot ยท OpenAI Codex
Documentation โReviewed 2026-08-07
Topics
agentagentic-aiautonomous-agentsclicollaborative-aiconversational-aigenaigenerative-aillmllm-orchestrationmodel-context-protocolmulti-agentpythonterminal-uitest-time-scalingtool-calling
- Stars
- 1,102โ
- Forks
- 170
- Language
- Python
- License
- NOASSERTION
- Created
- 2025-07-18
- Last push
- 2026-06-12