io.github.QuantuLabs/hivemind

Official

by QuantuLabs · TypeScript

Query multiple AI models (OpenAI, Anthropic, Google) for consensus responses.

Query multiple AI models simultaneously for consensus-based responses.

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 >= 18
Claude Code CLI installed
At least one API key: OpenAI or Google AI

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 (GPT-5.2)
Google AI (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

Initial Query: All 3 models receive the same question
Analysis: An orchestrator analyzes responses for agreements/divergences
Refinement: If no consensus, models see other perspectives and refine (up to 3 rounds)
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

code

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

Install

Configuration

Environment variables

OPENAI_API_KEYsecret

OpenAI API key for GPT-5.2

GOOGLE_API_KEYsecret

Google AI API key for Gemini

claude_desktop_config.json

{
  "mcpServers": {
    "hivemind": {
      "command": "npx",
      "args": [
        "-y",
        "@quantulabs/hivemind@0.1.3"
      ],
      "env": {
        "OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
        "GOOGLE_API_KEY": "<YOUR_GOOGLE_API_KEY>"
      }
    }
  }
}