io.github.QuantuLabs/hivemind
Query multiple AI models (OpenAI, Anthropic, Google) for consensus responses.
Open source Open in the app JSON README (API)
About
Query multiple AI models (OpenAI, Anthropic, Google) for consensus responses.
Details
- Kind
- MCP servers
- Topic
- AI, RAG & memory
- Publisher
- quantulabs
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.1.3
- Stars
- 1
- Last push
- 2026-01-26T08:03:27Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-29 03:02:11
- Updated
- 2026-08-29 03:02:11
- Origin id
io.github.QuantuLabs/hivemind
README
# Hivemind [](https://opensource.org/licenses/MIT) [](https://www.npmjs.com/package/@quantulabs/hivemind) Multi-model AI consensus platform that queries GPT-5.2, Claude Opus 4.5, and Gemini 3 Pro simultaneously to deliver synthesized, high-confidence responses. --- ## MCP Server for Claude Code Use Hivemind directly in Claude Code to get perspectives from GPT-5.2 and Gemini 3 Pro. Claude acts as the orchestrator and synthesizes the responses. ### Requirements - [Node.js](https://nodejs.org/) >= 18 - [Claude Code](https://claude.ai/code) CLI installed - At least one API key: [OpenAI](https://platform.openai.com/api-keys) or [Google AI](https://aistudio.google.com/apikey) > **Note:** No Anthropic API key needed - Claude is already your host! ### Installation ```bash npm install -g @quantulabs/hivemind claude mcp add hivemind -- hivemind ``` ### Configuration You need at least one API key, but both are recommended for better consensus: - [OpenAI](https://platform.openai.com/api-keys) (GPT-5.2) - [Google AI](https://aistudio.google.com/apikey) (Gemini 3 Pro) **Option 1: Paste directly (recommended)** ```bash /hive-config sk-proj-xxx... # OpenAI key /hive-config AIzaSy... # Google key ``` **Option 2: Config file** Create `~/.config/hivemind/.env`: ```bash OPENAI_API_KEY=sk-... GOOGLE_API_KEY=AIza... # Optional: Override default models OPENAI_MODEL=gpt-5.1 GOOGLE_MODEL=gemini-2.5-flash ``` > A `.env.example` template is included in the package. <details> <summary>Using with other MCP clients (non-Claude Code)</summary> For standalone MCP usage, you can also add an Anthropic key to include Claude in the consensus: ```bash ANTHROPIC_API_KEY=sk-ant-... ``` Disable Claude Code mode via `/hive-config` > Settings > Claude Code Mode. </details> ### Usage ```bash /hive "Why is my WebSocket connection dropping?" ``` Claude orchestrates the consensus from GPT-5.2 and Gemini 3 Pro responses. ### Available Tools | Tool | Description | |------|-------------| | `hivemind` | Query models and get synthesized consensus | | `configure_keys` | Set API keys (stored securely) | | `check_status` | Check configuration and active providers | | `configure_hive` | Toggle grounding search and settings | | `check_stats` | View token usage and cost statistics | ### Claude Code Commands - `/hive <question>` - Orchestrate multi-model consensus with Claude as the synthesizer - `/hive-config` - Configure API keys and settings - `/hivestats` - View usage statistics ### Automatic Hivemind Fallback Copy `CLAUDE.md.example` to your project's `.claude/CLAUDE.md` to enable automatic Hivemind consultation when Claude is stuck (after 3+ failed attempts). ### Prompt Caching All providers use optimized caching for cost reduction on follow-up queries: | Provider | Type | Savings | Min Tokens | |----------|------|---------|------------| | OpenAI | Automatic | 50% | 1024 | | Gemini 2.5+ | Implicit | 90% | - | | Anthropic | Explicit | 90% | 1024 | --- ## Web Interface A full-featured web app with solo mode, hivemind mode, and conversation history. ### Quick Start ```bash # Clone the repository git clone https://github.com/QuantuLabs/hivemind.git cd hivemind # Install dependencies (requires Bun >= 1.0) bun install # Start development server bun dev ``` Open `http://localhost:3000`, click the settings icon, and enter your API keys. ### Features - **Multi-Model Consensus**: Query 3 leading AI models simultaneously - **Deliberation Algorithm**: Up to 3 rounds of refinement to reach consensus - **Solo Mode**: Chat with individual models (GPT, Claude, Gemini) - **Hivemind Mode**: Get synthesized responses from all models - **Conversation History**: Persistent chat sessions - **Dark/Light Theme**: Full theme support - **Secure Storage**: API keys encrypted with AES-GCM in browser ### Security - API keys are encrypted using AES-GCM with PBKDF2 key derivation - Keys are stored locally in browser localStorage (never sent to servers) - Session persistence uses sessionStorage (cleared on browser close) --- ## How Consensus Works 1. **Initial Query**: All 3 models receive the same question 2. **Analysis**: An orchestrator analyzes responses for agreements/divergences 3. **Refinement**: If no consensus, models see other perspectives and refine (up to 3 rounds) 4. **Synthesis**: Final response synthesizes agreed points and addresses divergences ## Supported Models ### OpenAI - GPT-5.2 (default) - GPT-5.1, GPT-5, GPT-5 Mini, GPT-5 Nano - O4 Mini ### Anthropic - Claude Opus 4.5 (default) - Claude Sonnet 4.5, Claude Opus 4, Claude Sonnet 4 ### Google - Gemini 3 Pro (default) - Gemini 3 Flash, Gemini 2.5 Pro/Flash/Flash Lite, Gemini 2.0 Flash ## Project Structure ``` hivemind/ ├── apps/ │ └── web/ # Next.js 14 frontend ├── packages/ │ ├── core/ # Shared consensus logic & providers │ └── mcp/ # Model Context Protocol server └── .claude/ # Claude Code integration ``` ## Development ```bash # Run all tests bun test # Run tests with coverage bun test:coverage # Build all packages bun build # Lint code bun lint ``` ## License MIT --- Developed by [QuantuLabs](https://github.com/QuantuLabs)