加入 HiveMind La Ruche

1. 使用 AI 模型

1. 使用您选择的昵称创建账户。该昵称是公开的（可能出现在列表和消息总线上），请选择 1 到 64 个 ASCII 字母、数字或 . _ @ + -。

curl -s https://hivemind-openrouter-1003063861791.us-central1.run.app/v1/hivemind/register -H "Content-Type: application/json" -d '{"handle":"your-handle","role":"consumer"}'

2. 响应中包含您的 API 密钥（api_key）。密钥仅显示一次且无法找回，请妥善保管。如果丢失，请注册一个新昵称。
3. 新账户初始为 0 积分（除非管理员授予初始积分）。积分可通过共享 GPU（方式 2）或申请试用获得：如果您只想体验，请在 GitHub Issue 中申请。
4. 测试您的密钥：

export HIVEMIND_API_KEY=hm-YOUR_KEY
curl https://hivemind-openrouter-1003063861791.us-central1.run.app/v1/chat/completions \
  -H "Authorization: Bearer $HIVEMIND_API_KEY" -H "Content-Type: application/json" \
  -d '{"model":"hivemind/auto","messages":[{"role":"user","content":"Hello!"}]}'

在代码编辑器（VS Code、Continue 等）中，请参阅连接指南。

2. 共享您的 GPU 回答问题

您的电脑运行模型，网关向其转发提问，您将根据生成的词元（tokens）获得积分。此过程需要使用命令行终端。

1. 获取代码（需要 Python 3.11 或 3.12）：

git clone https://github.com/xaviercallens/HiveMind.git && cd HiveMind
pip install httpx fastapi uvicorn

2. 查找适合您显卡的模型（下方表格列出了全部模型）。此命令仅读取显存容量，无需账户：

python scripts/hivemind_producer_agent.py --gateway https://hivemind-openrouter-1003063861791.us-central1.run.app --suggest --detect-vram

3. 安装 Ollama，然后下载建议的模型，例如：

ollama pull qwen2.5-coder:3b

4. 以相同方式创建生产者账户，设置 "role":"producer"（若同时想调用模型可设为 "prosumer"），并妥善保存密钥。

5. 您的电脑必须能通过公共 https 地址访问：网关拒绝普通 http 和私有内网地址。在家庭网络中，您可以在生产者安全盾（shield）前配置隧道或反向代理。请使用 curl https://YOUR_ENDPOINT/v1/models 进行验证。
6. 启动安全盾与代理程序（完整参数见生产者指南）。首次运行可加上 --once 查看网关响应：

export HIVEMIND_API_KEY=hm-YOUR_PRODUCER_KEY
export HIVEMIND_ENDPOINT_TOKEN="$(python -c 'import secrets;print(secrets.token_urlsafe(32))')"
python scripts/hivemind_producer_shield.py --upstream http://127.0.0.1:11434 --port 8787 --allow-model qwen2.5-coder:3b &
python scripts/hivemind_producer_agent.py --gateway https://hivemind-openrouter-1003063861791.us-central1.run.app --endpoint https://YOUR_ENDPOINT --preset coder-lite --once

在 Windows (PowerShell) 中，请使用 $env:NAME="value" 代替 export 设置环境变量。移除 --once 即可保持代理持续运行。

您可以随时停止：在心跳信号中断约两分钟后，网关会自动停止向您发送请求。

3. 夜间使用 BOINC 训练模型

此通道已向公众开放：联邦 BOINC 与 Night-MoE 协调器已在 HiveMind La Ruche 上线（实时 Night-MoE 遥测见 /night-moe，公民科学排行榜见 /community）。您今天即可检测硬件并领取计算任务。

• 原生 BOINC 便携包支持 x86-64 Linux，Python BOINC/BLS 工作节点支持 Linux、Windows 和 macOS
• 至少配备 3.5 GB 显存的 NVIDIA 显卡
• 首次下载约 4.4 GB，后续任务可重复使用
• 社区训练任务在巴黎时间夜间 22:00–07:00 网络空闲时段开放
• 兼容标准 BOINC 客户端；所有项目文件均带有数字签名

1. 首先运行只读硬件预检脚本（不安装任何软件，也不发送任何数据）：

python3 scripts/hivemind_volunteer_preflight.py

2. 从公共协调器领取并计算实时联邦 BOINC 任务（支持 physics_sim、code_generation 或 math_reasoning，移除 --once 可在夜间持续计算）：

python3 scripts/hivemind_boinc_idle_worker.py --coordinator https://hivemind-at-home-ruche-cfhmhmvv5a-uc.a.run.app --handle your-handle --domain physics_sim --once

4. 游戏玩家与 Steam

您的 GPU 仅在您不玩游戏时计算天体物理与 AI 任务。Steam 免费版（USS HiveMind NCC-31337: Astrophysics Exoplanet Hunter，Steam AppID 3133700）与 GPU 空闲自动暂停代理今日均已开放，在实时社区中心将游戏玩家与公民科学家紧密连接。

当您正在游戏时（键盘/鼠标空闲 < 4 秒或 GPU 负载高于 45%），BOINC GPU 计算会自动暂停（boinccmd --set_gpu_mode never，0% GPU 额外开销），确保游戏独占 100% 显卡性能并稳定 60 FPS。在空闲满 4 秒后（且 GPU 负载低于 45%、温度低于 78 °C），程序会自动恢复折叠 TESS/JWST 系外行星凌星光变曲线。

1. 启动 GPU 空闲自动暂停工作节点（移除 --once 可让自动暂停/恢复守护进程在您游戏期间持续后台运行）：

python3 scripts/hivemind_boinc_idle_worker.py --coordinator https://hivemind-at-home-ruche-cfhmhmvv5a-uc.a.run.app --handle your-handle --idle-threshold-seconds 4 --once

2. 您也可以在 Steam 启动选项中立即手动触发 GPU 暂停或恢复：

python3 scripts/hivemind_boinc_idle_worker.py --pause-now

3. 如果您同时运行了方式 2 的 Ollama 生产者节点，已加载的语言模型在无请求时仍会占用显存；在启动大型游戏前，请先停止代理（Ctrl+C）并卸载显存中的模型（将名称替换为您的模型）：

ollama stop qwen2.5-coder:3b

4. 游戏结束后：使用方式 2 中的相同命令重新启动生产者代理（BOINC 空闲 GPU 工作节点会自动恢复运行）。

重要须知

• 生产者节点可以看到发送给它们的问题。请勿在存有机密数据的机器上运行生产者节点，也不要向网络发送机密文本。
• 积分没有任何货币价值，也不构成任何形式的金钱报酬。
• 当您的 GPU 处理任务时会消耗电力。您可以使用 nvidia-smi --query-gpu=power.draw --format=csv 测量显卡功耗并乘以运行小时数。
• 本软件完全开源（AGPL-3.0 协议）。建议您在运行前审阅源代码。
• 该网络仍处于早期阶段并由志愿者维护，不保证全天候可用性。

问题与帮助

请在 GitHub 上提交 Issue（支持中文、法语或英语）。如遇安全问题，请先阅读安全策略。