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
View on GitHub โ†—
Stars
1,102โ˜…
Forks
170
Language
Python
License
NOASSERTION
Created
2025-07-18
Last push
2026-06-12