Hivemind

🚀 Hivemind

Hivemind 是一個多模型 AI 共識平臺，可同時查詢 GPT - 5.2、Claude Opus 4.5 和 Gemini 3 Pro，以提供綜合的、高可信度的響應。

🚀 快速開始

用於 Claude Code 的 MCP 服務器

可直接在 Claude Code 中使用 Hivemind，以獲取 GPT - 5.2 和 Gemini 3 Pro 的觀點。Claude 作為協調器對響應進行綜合處理。

要求

• Node.js >= 18
• 已安裝 Claude Code CLI
• 至少擁有一個 API 密鑰：[OpenAI](https://platform.openai.com/api - keys) 或 Google AI

⚠️ 重要提示

無需 Anthropic API 密鑰，因為 Claude 已經是你的主機！

安裝

npm install -g @quantulabs/hivemind
claude mcp add hivemind -- hivemind

配置

你至少需要一個 API 密鑰，但為了獲得更好的共識效果，建議同時使用兩個：

• [OpenAI](https://platform.openai.com/api - keys)（GPT - 5.2）
• Google AI（Gemini 3 Pro）

選項 1：直接粘貼（推薦）

/hive-config sk-proj-xxx...   # OpenAI 密鑰
/hive-config AIzaSy...        # Google 密鑰

選項 2：配置文件 創建 ~/.config/hivemind/.env：

OPENAI_API_KEY=sk-...
GOOGLE_API_KEY=AIza...

# 可選：覆蓋默認模型
OPENAI_MODEL=gpt-5.1
GOOGLE_MODEL=gemini-2.5-flash

包中包含 .env.example 模板。

ANTHROPIC_API_KEY=sk-ant-...

使用方法

/hive "Why is my WebSocket connection dropping?"

Claude 會協調 GPT - 5.2 和 Gemini 3 Pro 的響應以達成共識。

可用工具

Claude Code 命令

• /hive <問題> - 以 Claude 為綜合器協調多模型共識
• /hive-config - 配置 API 密鑰和設置
• /hivestats - 查看使用統計信息

Hivemind 自動回退

將 CLAUDE.md.example 複製到項目的 .claude/CLAUDE.md，以便在 Claude 陷入困境（3 次以上失敗嘗試後）自動諮詢 Hivemind。

提示緩存

所有提供商都使用優化的緩存來降低後續查詢的成本：

💻 網頁界面

這是一個功能齊全的網頁應用程序，具有單模型模式、hivemind 模式和對話歷史記錄功能。

快速開始

# 克隆倉庫
git clone https://github.com/QuantuLabs/hivemind.git
cd hivemind

# 安裝依賴（需要 Bun >= 1.0）
bun install

# 啟動開發服務器
bun dev

打開 http://localhost:3000，點擊設置圖標，輸入你的 API 密鑰。

特性

• 多模型共識：同時查詢 3 個領先的 AI 模型
• 審議算法：最多進行 3 輪優化以達成共識
• 單模型模式：與單個模型（GPT、Claude、Gemini）聊天
• Hivemind 模式：從所有模型獲取綜合響應
• 對話歷史記錄：持久的聊天會話
• 黑暗/明亮主題：支持完整的主題
• 安全存儲：API 密鑰在瀏覽器中使用 AES - GCM 加密

安全性

• API 密鑰使用 AES - GCM 和 PBKDF2 密鑰派生進行加密
• 密鑰本地存儲在瀏覽器的 localStorage 中（從不發送到服務器）
• 會話持久性使用 sessionStorage（瀏覽器關閉時清除）

🔧 共識工作原理

1. 初始查詢：所有 3 個模型接收相同的問題
2. 分析：協調器分析響應的一致性/差異
3. 優化：如果沒有達成共識，模型會參考其他觀點並進行優化（最多 3 輪）
4. 綜合：最終響應綜合一致點並處理差異

📚 支持的模型

OpenAI

• GPT - 5.2（默認）
• GPT - 5.1、GPT - 5、GPT - 5 Mini、GPT - 5 Nano
• O4 Mini

Anthropic

• Claude Opus 4.5（默認）
• Claude Sonnet 4.5、Claude Opus 4、Claude Sonnet 4

Google

• Gemini 3 Pro（默認）
• Gemini 3 Flash、Gemini 2.5 Pro/Flash/Flash Lite、Gemini 2.0 Flash

📁 項目結構

hivemind/
├── apps/
│   └── web/              # Next.js 14 前端
├── packages/
│   ├── core/             # 共享的共識邏輯和提供商
│   └── mcp/              # 模型上下文協議服務器
└── .claude/              # Claude Code 集成

🛠️ 開發

# 運行所有測試
bun test

# 運行帶覆蓋率的測試
bun test:coverage

# 構建所有包
bun build

# 代碼檢查
bun lint

📄 許可證

MIT

由 QuantuLabs 開發