agi

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

• Node.js/JavaScript 运行环境（项目为 JavaScript 编写，README 未给出具体版本要求）
• 已安装 Hyperspace CLI（README 未提供安装命令，需从 官网 agents.hyper.space 获取）
• 组建 Pod 需要多名成员的机器共同加入
• 自托管场景需要本机已安装 Docker 与 Docker Compose

安装与启动步骤

1. 1准备 CLI 环境

   README 未提供 CLI 安装命令，请先前往官网 agents.hyper.space 获取并安装 Hyperspace CLI，安装成功后再执行后续命令。

2. 2创建 Pod

   由一名成员创建一个私有 AI 集群（Pod），名称可自定义；创建后即可邀请其他成员加入组成 mesh。

   hyperspace pod create "my-lab"

   复制

3. 3生成邀请链接

   创建者执行后获得可分享的邀请链接，把它发给需要加入集群的同伴，对方安装 CLI 后即可加入。

   hyperspace pod invite

   复制

4. 4查看已连接成员

   确认哪些成员的机器已经接入集群，用于排查是否有人未成功加入 mesh。

   hyperspace pod members

   复制

5. 5查看集群模型

   列出整个集群中所有已加载的模型，便于判断推理请求会被路由到哪台成员机器。

   hyperspace pod models

   复制

6. 6自托管 Pod

   README 提到可通过 docker compose up 自托管 Pod，用于长期运行或迁移后的自建部署。

   docker compose up

   复制

如何确认成功

执行 hyperspace pod members 能看到已连接成员、hyperspace pod models 能列出集群内模型，说明 Pod 集群已组建成功。

常见问题

注意事项

• README 未给出 Hyperspace CLI 的安装命令、网络加入方式和端口信息，相关步骤请以官网 agents.hyper.space 为准。
• 示例中的 "my-lab" 只是 Pod 名称占位，实际执行时可替换为你自己的名称。
• 共享 OpenRouter / Groq / Together 密钥时建议为每个成员设置预算，避免额度被耗尽。
• Pod Capsule 含完整状态并使用 AES-256-GCM 加密，请妥善保管与传输对应密钥。