README 的“Features”与“Download”章节:每个 agent 有独立 workspace、transcript、memory 和 bounded permissions;Windows 10/11 提供 64-bit 安装包。
StarNet:让本地 AI 代理在像素空间里真实协作
给开发者管理真实 AI 代理的本地桌面站,把像素房间直接变成能力和工作流。
🧭 决策指南
为什么现在热: 无法从材料判断
适合,如果你
-
你要在 Windows 10/11 上并发运行多个拥有独立 workspace 和 bounded permissions 的 AI agent。
-
你希望使用 Ollama 的本地模型而不配置 API key 或账户。README 的“Run free with a local model”章节:执行 `ollama pull llama3.1`,选择 `OLLAMA`,连接 `127.0.0.1:11434`。
-
你需要把代理连接到 Telegram、Discord、Slack、Signal 或 Matrix。README 的“Features”章节“Message it from anywhere”:列出了 Telegram、Discord、Slack、Signal 和 Matrix。
-
你需要落盘保存 agent memory、transcripts、spend、tasks 和 schedules。README 的“What is real”章节明确说明这些数据持久化在磁盘上。
不适合,如果你
-
你的部署目标是 Linux 公共桌面发行版。README 的“Download”章节明确写明 Linux packages 是 internal build artifacts,不是 supported public release target。
-
你要求本地模型在长任务上达到云模型的速度和质量。README 的“Run free with a local model”章节说明 Ollama 本地模型更小,长任务更慢且更粗糙。
-
你需要直接把 StarNet 名称、Logo 或 station artwork 用于商业衍生发行。README 的“License”章节说明 MIT 只覆盖代码,fork 必须使用自己的名称、Logo 和 artwork。
-
你只接受完全不向外发送 provider 请求的运行方式。README 的“Run from source”章节说明运行 agent 时 provider requests leave your machine;仅 station state、transcripts、memory 和 ledgers 默认留在本地。
前置条件
- 源码运行需要 Node.js 18+,README 说明 Node.js 22 matches CI。
- 源码运行需要 Git。
- 桌面 shell 仅在开发时需要 Rust 和 Tauri prerequisites。
- 使用 Ollama 需要安装 Ollama,并执行 `ollama pull llama3.1`。
- Windows 公共发行版提供 `StarNet__x64-setup.exe`。
- macOS Apple Silicon 应使用原生 `StarNet__aarch64.dmg`,不要在 Apple Silicon 上使用 `x64` DMG。
第一步命令(README 原文)
git clone https://github.com/androoAGI/starnet.git
要注意
-
Apple Silicon 必须选择 `StarNet__aarch64.dmg`,x64 DMG 会通过 Rosetta 2 运行。README“Download”章节的 Apple Silicon note。
-
运行源码时必须先启动 `node sidecar/index.js`,README 将其列为 sidecar 启动命令。README“Run from source”章节。
-
API keys 不会从 OpenClaw 或 Hermes 导入,需要在 KEYS tab 重新输入。README“Coming from OpenClaw or Hermes?”章节。
-
`npm run qa:ready` 的 READY receipt 会因新 commit 失效,受影响的 live gates 必须重跑。README“Testing”章节。
-
`npm run security:secrets` 需要 Gitleaks 位于 PATH 中。README“Testing”章节。
替代方案
-
OpenClaw:你已有 OpenClaw home,并希望继续使用其现有 agent 体系,而不是导入到 StarNet。README“Coming from OpenClaw or Hermes?”章节
-
Hermes:你已有 Hermes home,并希望直接保留 Hermes 运行环境,而不是迁移 persona、instructions、memory 和 model。README“Coming from OpenClaw or Hermes?”章节
-
Ollama:你只需要本地模型运行,不需要 StarNet 的像素空间、多个 agent、OUTBOX 或连接器功能。README“Run free with a local model”章节
材料未说明
- README 未说明 Windows 与 macOS 的最低硬件配置。
- README 未给出 Anthropic、OpenAI、Google 支持的具体模型列表或版本范围。
- README 未给出多个 agent 并发运行时的资源上限或推荐规模。
- README 未量化 Ollama 与云端模型在长任务上的速度和质量差异。
- README 未说明 478 个 Star、91 个 Fork 与 24 个 Issue 的具体时间序列变化。
- README 未说明 2026-09-26 发布的 StarNet v0.12.4 是否包含某项特定功能或修复。
- README 未说明 macOS“less real-world coverage”对应的具体测试矩阵。
- README 未说明连接 Telegram、Discord、Slack、Signal、Matrix 所需的配置步骤和权限范围。
💡 深度解析
6
不适合
我只能使用 Linux 工作站,并要求像 Windows 10/11 64 位和 macOS 一样拿到受支持的公共发行包;StarNet 是否适合这个部署约束?
适合读者: 计划把 StarNet 部署到 Linux 工作站,并希望获得像 Windows 10/11 64 位和 macOS 一样的公共发行包与官方支持的开发者
不适合,因为 README 明确把 Linux 构建产物限定为内部产物,而公共发行版只支持 Windows 和 macOS。
- Download 章节列出的公共资产只有 Windows 10/11 64-bit、macOS Apple Silicon 和 macOS Intel。
- README 直接写明 “Linux packages are internal build artifacts only and are not a supported public release target”。这不满足需要官方公共包的部署约束。
- 项目虽然可以从源码启动 Node sidecar,且 sidecar 只依赖 Node core modules,但这不等于 Linux 桌面壳、安装包、更新器和完整体验得到公共支持。
- 发布流水线对 Windows Authenticode、Mac Developer ID、notarization 和 updater signature 有明确门禁;README 没有给出对应的 Linux 发布门禁。
- Download:"Linux packages are internal build artifacts only and are not a supported public release target"
- Download 表:公共平台为 Windows 10/11 64-bit 和 macOS
- Run from source:"The sidecar uses Node core modules only"
git clone https://github.com/androoAGI/starnet.git
cd starnet
node sidecar/index.js
视情况
我在 M2 Mac 上使用 StarNet,要求桌面应用原生运行而不是通过 Rosetta 2;我应该选择哪个发行包,macOS 支持是否足够成熟?
适合读者: 使用 Apple Silicon M1–M4 Mac、希望安装 macOS 桌面版并避免 Rosetta 2 性能损失的个人开发者
视情况,架构选择明确且可以原生运行,但 macOS 的真实覆盖少于 Windows,早期发布状态使它不适合把兼容性当作已充分验证的前提。
- README 为 Apple Silicon M1–M4 提供
StarNet__aarch64.dmg,并明确要求不要在 Apple Silicon 上使用 x64 DMG,因为那会经过 Rosetta 2。 - 公共发行版支持 Windows 和 macOS,发布流水线要求 macOS Developer ID 检查与 Apple notarization。
- README 同时说明 Windows 是测试最充分的平台,macOS has less real-world coverage,并将项目标为 Early release。
- Linux 不是受支持的公共发行目标;这不会影响 M2 安装,但说明跨平台覆盖并不统一。
- Download:"macOS — Apple Silicon (M1–M4)" 与 `StarNet__aarch64.dmg`
- Apple Silicon note:"Avoid the x64 DMG on Apple Silicon"
- Download:"Windows is the most-tested desktop target. macOS has less real-world coverage."
适合
我已有 OpenClaw 或 Hermes 的 on-disk home,想迁移 persona、instructions、memory 和 model,但不希望 API key 自动转移;StarNet 能否满足这个迁移约束?
适合读者: 已经维护 OpenClaw 或 Hermes agent home、希望保留 persona、instructions、memory 和 model 配置并迁移到桌面工作台的开发者
适合,README 明确支持从 OpenClaw 或 Hermes 的磁盘目录导入 Agent,并把 API key 排除在迁移之外。
- 导入器会读取现有 home 中找到的 persona、instructions、memory 和 model,并据此 mint a StarNet agent。
- API keys never transfer,迁移完成后必须在 KEYS tab 重新输入;这符合不复制密钥的约束。
- 导入结果进入 StarNet 的 Agent 工作区和本地运行时,但 README 没有保证 OpenClaw 或 Hermes 的全部工具、调度和连接器语义都能一一转换。
- StarNet 的模型提供商可使用 OpenRouter 或支持的 OAuth 登录,也可选择 Ollama,因此迁移后的 provider 仍需要重新配置。
- Coming from OpenClaw or Hermes?:"it mints a StarNet agent from the persona, instructions, memory, and model it finds"
- Coming from OpenClaw or Hermes?:"API keys never transfer — you re-enter those in the KEYS tab"
- Features:"Bring your own models"
适合
我已有 Node.js 18+ 环境,前端想继续用原生 JavaScript,但桌面壳需要 Rust/Tauri;StarNet 的源码结构是否适合我接入和扩展?
适合读者: 维护 Node.js 18+ sidecar、希望用原生 JavaScript 前端并通过 Rust/Tauri 打包 Windows 和 macOS 桌面应用的开源贡献者
适合,项目边界清晰地拆分了 vanilla JavaScript 前端、Node sidecar、shared 契约和 Rust/Tauri 外壳;不过只运行 sidecar 不等于完成桌面应用构建。
- frontend/负责 station world 和 desktop UI,sidecar/负责 providers、tools、persistence、budgets 和 consent。
- shared/维护跨边界 event/schema contracts,前端通过 localhost HTTP/NDJSON 和 SSE 消费真实运行事件。
- README 说明 sidecar 只用 Node core modules,Node.js 18+ 即可运行;桌面 shell 才需要 Rust 与 Tauri prerequisites。
- 桌面开发还提供
npm ci、npm run desktop:dev和npm run desktop:build,因此扩展运行时与打包流程是分开的。
- Run from source:"Requirements: Node.js 18+"
- Architecture 表:frontend、sidecar、shared、src-tauri 的职责划分
- Run from source:"The sidecar uses Node core modules only"
npm ci
npm run desktop:dev # dev shell
npm run desktop:build # build installers locally
适合
我需要多个 Agent 并发跑多步骤 Recipe,并在离开电脑后通过 cron、Telegram 或 Discord继续执行;StarNet 能否覆盖这套工作流?
适合读者: 想让多个 Agent 并发执行 Recipes,并通过 cron、Telegram 或 Discord 远程管理 Night Shift 的个人开发者
适合,因为 README 直接覆盖并发 Agent、Recipes、cron schedules、远程消息渠道和 Night Shift;但执行边界仍依赖你配置的权限与停止条件。
- 每个并发 Agent 都有独立 workspace、transcript、memory 和 bounded permissions,不是只播放界面动画。
- Recipes 可启动 proven multi-step tasks,schedules 可通过 cron 安排工作,并显示输出。
- Telegram、Discord、Slack、Signal 和 Matrix 都是列出的接入渠道,Task Briefs 还能通过 connected channel 询问歧义。
- Night Shift 会在离开后继续工作,但 away-actions 会被记录并可审查;README 没有承诺任务一定成功或自动解决所有协作冲突。
- Features:"Run several at once"、"Recipes, skills, schedules"、"Night Shift"
- Features:"Wire agents to Telegram, Discord, Slack, Signal, or Matrix"
- What is real:"Multiple agents run concurrently with separate workspaces and bounded permissions"
git clone https://github.com/androoAGI/starnet.git
cd starnet
node sidecar/index.js
视情况
我需要本地保留 Agent 状态和成本账本,但复杂任务仍想调用 OpenRouter 或 Anthropic;StarNet 是否适合我的数据边界?
适合读者: 需要把 Agent 状态、转录、记忆和账本留在本机,同时偶尔调用 OpenRouter、Anthropic、OpenAI 或 Google 云模型的个人开发者
视情况,适合“本地保存运行状态、按需把模型请求发到云端”的边界,但不适合要求所有任务数据绝不离开设备的环境。
- README 明确写明 Agent 状态、transcripts、memory 和 ledgers 留在本地 StarNet workspace。
- 使用 OpenRouter、Anthropic、OpenAI 或 Google 时,provider requests 会离开设备;启用 network tool 或 connector 还会扩大数据流范围。
- 密钥由 sidecar 或 OS keychain 保存,前端不直接持有;这能缩小密钥暴露面,但不能阻止发送给云模型的上下文离开设备。
- 如果必须无云运行,可使用 Ollama;README 的限制是本地模型更小,长任务会更慢且结果更粗糙。
- Run from source:"station state, transcripts, memory, and ledgers stay in the local StarNet workspace"
- Run free with a local model:"local models are smaller than the cloud ones, so expect slower and rougher work on long tasks"
- Architecture:"Secrets are held by the sidecar / OS keychain, never in the frontend"
ollama pull llama3.1
✨ 核心亮点
-
多个 AI agent 并发运行,各自拥有 workspace 与权限
-
模型调用经由本地 Node sidecar,状态与账本落盘
-
支持 OpenRouter、Anthropic、OpenAI、Google 与 Ollama
-
Windows 10/11 支持更充分,macOS 真实覆盖较少
🔧 工程化
-
用像素空间映射能力、交接通道与 agent 工作流
-
通过 Telegram、Discord、Slack、Signal、Matrix 连接代理
-
用 Night Shift、cron 与 Recipes 持续执行任务
-
OUTBOX 以真实文件交付结果,非聊天记录滚动区
⚠️ 风险
-
云端 provider 请求会离开本机,需查看 PRIVACY.md 数据说明
-
Linux 仅是内部构建产物,不属于公开支持目标
-
Ollama 本地模型更小,长任务会更慢且结果更粗糙
-
MIT 只覆盖代码,StarNet 名称、Logo 与素材不随许可证开放
👥 适合谁?
-
需要在 Windows 10/11 上运行多 agent 工作流的开发者
-
使用 Ollama、OpenRouter 或 Anthropic 的本地优先团队
-
需要 workspace、权限、transcript 与 spend 记录的用户