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 开发