androoAGI/starnet 来源: https://github.com/androoAGI/starnet

一个由真实AI代理执行真实工作的动态像素画风工作站。

下载 (链接) 平台支持 许可证: MIT 本地优先

下载 (链接) · 安装指南 · 从源代码运行 · 文档 · 参与贡献

StarNet 是一个本地优先的桌面工作环境，在这里你可以创建AI代理，将它们组织成一个像素画风的空间站，并观看它们使用真实的模型和工具执行真实的工作。这个空间站不是装饰品——它是实时运行状态的映射，产品契约非常字面化：一个房间是一个能力范围定义的团队，一条走廊是一条授权的交接通道，而一个放置的物体则是一项真实的能力授予。你绘制的布局就是代理执行的工作流程。

从一个代理开始，然后放置舱位或召唤专家来并发运行更多代理——每个都是一个真正独立、边界明确的代理运行实例，拥有自己的工作空间和权限。该工作环境执行的是真实的模型调用、真实的工具、产生真实的成本，而非模拟动画。

功能特性

什么是真实的

• 模型调用通过本地的 Node 辅助进程流式传输。
• 工具操作通过明确的能力和同意检查。
• 代理的记忆、对话记录、消耗记录、任务和计划在磁盘上持久化。
• 多个代理并发运行，拥有独立的工作空间和受约束的权限。
• 可视化的空间站投影的是工作环境能够证明的、相同的运行状态。

StarNet 不模拟收入、已完成工作、模型活动或消耗。其核心产品准则是：界面永远不得断言工作环境无法证明的状态。

下载

桌面版本发布在 StarNet 发布页面 (链接)。

Apple Silicon 用户注意： 请使用原生 aarch64 DMG。避免在 Apple Silicon 上使用 x64 DMG：它将通过 Rosetta 2 运行，而非使用原生架构。

公开发布版本支持 Windows 和 macOS。除非 Windows 安装程序通过了 Authenticode 和时间戳验证，两个 Mac 版本通过了开发者 ID 检查和 Apple 公证，并且每个更新程序工件都具有有效的更新签名，否则发布流程将拒绝准备发布。这些是流程要求，并非证明某个下载或安装的副本已在您的机器上测试过；INSTALL.md 解释了需要验证什么以及何时停止。

Linux 软件包仅是内部构建工件，不属于受支持的公开发布目标。

早期发布： Windows 是经过最多测试的桌面平台。macOS 的真实覆盖较少。遇到问题？请告知我们： [email protected]。

从源代码运行

要求： Node.js 18+（Node.js 22 与 CI 一致），Git。仅构建桌面外壳时需要 Rust 和 Tauri 先决条件 (https://v2.tauri.app/start/prerequisites/)。辅助进程仅使用 Node 核心模块，因此无需安装任何东西即可运行：

git clone https://github.com/androoAGI/starnet.git
cd starnet
node sidecar/index.js

打开界面，然后连接提供商——自带你的 OpenRouter API 密钥 (BYOK) 或使用支持的 OAuth 登录。运行代理时，提供商的请求会离开你的机器；除非你明确使用网络工具或连接器，否则空间站状态、对话记录、记忆和账本都保留在本地的 StarNet 工作空间中。完整的数据映射请参见 PRIVACY.md。

使用本地模型免费运行

无需密钥、无需账户、无需账单：安装 Ollama (https://ollama.com)，拉取模型（ollama pull llama3.1），并选择 OLLAMA 作为提供商——在首次运行的引导界面或稍后在 设置 → 提供商 中设置。StarNet 通过 127.0.0.1:11434 与 Ollama 通信，并且只有在能列出你的本地模型后才报告其就绪。诚实提醒：本地模型比云端模型更小，因此在处理长任务时预期速度较慢、结果较粗糙。

进行桌面开发：

npm ci
npm run desktop:dev    # 开发环境外壳
npm run desktop:build  # 本地构建安装程序

来自 OpenClaw 或 Hermes？

StarNet 可以导入现有的代理：将其指向你磁盘上的 OpenClaw 或 Hermes 主目录，它会根据找到的角色、指令、记忆和模型铸造一个 StarNet 代理。API 密钥永远不会转移——你需要在“密钥”标签页中重新输入。

架构

前端通过本地主机的 HTTP/NDJSON 和 SSE 消费真实的辅助进程事件。密钥属于本地权限：密钥由辅助进程/操作系统密钥链持有，绝不在前端。

从 docs/INDEX.md 开始了解实时文档。较旧的规划文档仍保留在仓库中作为设计历史，并相应标记。

测试

npm run test:fast      # 必需的合并门控
npm run test:http      # 实时辅助进程 HTTP/E2E 测试套件
npm test               # 验证 + 世界 + 快速 + HTTP 套件
npm run security:secrets # 全历史密钥扫描；需要 Gitleaks 在 PATH 中

发布就绪状态通过 npm run qa:ready 汇总。它基于候选版本：任何新的提交都会使先前的 READY 回执失效，直到受影响的实时门控被重新运行。

参与贡献与安全

欢迎贡献——请阅读 CONTRIBUTING.md 并遵守 行为准则。不要在公开 issue 中报告漏洞。请按照 SECURITY.md 的说明进行私下报告。

许可证

StarNet 根据 MIT 许可证 开源。第三方组件保留其原始许可证——请参阅 NOTICE.md。

MIT 许可证仅涵盖代码。 StarNet 名称、徽标、空间站美术资源和精灵图以及项目的其他品牌资产归 Andrew Sims 所有，并未随此许可证一同授权——未明确或暗示授予任何商标或其他品牌权利。MIT 意味着你可以分叉、修改和再分发代码，包括商业用途。你不能做的是将其作为 StarNet 发布：分叉和衍生作品必须使用自己的名称、徽标和美术资源，并且不得声称自己是本项目或本项目的认可项目。