androoAGI / starnet

A living pixel-art station where real AI agents do real work. Download · Install guide · Run from source · Docs · Contributing 一个充满活力的像素风空间站，让真实的 AI 智能体在此执行真实的工作。下载 · 安装指南 · 源码运行 · 文档 · 贡献指南

StarNet is a local-first desktop harness where you create AI agents, organize them into a pixel-art space station, and watch them perform real work with real models and tools. The station is not decoration — it is a projection of live runtime state, and the product contract is literal: A room is a capability-scoped team, a hallway is an authorized handoff lane, and a placed object is a real capability grant. The layout you draw is the workflow the agents run. Start with one agent, then place bays or summon specialists to run more, concurrently — each a genuinely distinct, bounded agent run with its own workspace and permissions. The harness performs real model calls, real tools, real cost rather than animating a simulation. StarNet 是一个以本地优先的桌面端框架，你可以在其中创建 AI 智能体，将它们组织进一个像素风的空间站，并观察它们利用真实模型和工具执行实际工作。这个空间站并非装饰，而是实时运行状态的投影，其产品逻辑非常直观：一个房间代表一个具备特定能力的团队，走廊是授权的交接通道，而放置的物体则代表真实的权限授予。你绘制的布局就是智能体运行的工作流。从一个智能体开始，然后放置工作舱或召唤专家来并发运行更多智能体——每一个都是独立且受限的智能体，拥有自己的工作空间和权限。该框架执行的是真实的模型调用、真实的工具操作和真实的成本消耗，而非模拟动画。

Features

功能特性

A crew, not a chatbot Create agents with distinct classes, personas, and loadouts. Run several at once — each gets its own workspace, transcript, memory, and bounded permissions. 团队，而非聊天机器人 创建具有不同类别、个性和配置的智能体。同时运行多个智能体——每一个都拥有独立的工作空间、对话记录、记忆和受限权限。

Bring your own models Paste an OpenRouter key, or sign in with supported provider accounts (Anthropic, OpenAI, Google) — keys live in the OS keychain, never in the frontend. 使用你自己的模型 粘贴 OpenRouter 密钥，或登录支持的服务商账号（Anthropic、OpenAI、Google）——密钥存储在操作系统钥匙串中，绝不会出现在前端。

Message it from anywhere Wire agents to Telegram, Discord, Slack, Signal, or Matrix and talk to your station away from the desk. 随时随地发送消息 将智能体连接到 Telegram、Discord、Slack、Signal 或 Matrix，即使离开电脑也能与你的空间站对话。

Night Shift Leave the station running and agents keep working inside an explicit, adjustable leash — every away-action is logged and reviewable. 夜班模式 让空间站保持运行，智能体会在明确且可调的限制范围内继续工作——每一次离线操作都会被记录并可供审查。

Recipes, skills, schedules Launch proven multi-step recipes, grant reusable skills, and put work on cron schedules with visible output. 配方、技能与调度 启动经过验证的多步配方，授予可复用的技能，并通过 Cron 调度安排工作，同时提供可见的输出。

Asks before it guesses Task Briefs turn ambiguity into one concrete question with options — over any connected channel — instead of a silent wrong guess. 先询问，后猜测 任务简报（Task Briefs）会将模糊的需求转化为一个带有选项的具体问题，并通过已连接的渠道发送给你，而不是默默地做出错误的猜测。

Finished work has a front door Deliverables land in the OUTBOX as real files you open, not chat scrollback you archaeology. 成品交付有据可查 交付成果会存放在 OUTBOX 中，作为你可以直接打开的真实文件，而不是需要你去聊天记录里翻找的碎片信息。

MCP connectors Attach Model Context Protocol servers and paste-a-key/OAuth connectors to extend what agents can touch. MCP 连接器 挂载模型上下文协议（MCP）服务器，并使用密钥粘贴或 OAuth 连接器，以扩展智能体的操作范围。

Voice Push-to-talk dictation in, one consistent station voice out. 语音 支持按键说话输入，并提供统一的空间站语音输出。

Real ledgers Spend, budgets, and run history persist on disk and are shown as-is. 真实账本 支出、预算和运行历史记录会持久化存储在磁盘上，并如实呈现。

What is real

什么是真实的

Model calls stream through the local Node sidecar. Tools operate through explicit capability and consent checks. Agent memory, transcripts, spend records, tasks, and schedules persist on disk. Multiple agents run concurrently with separate workspaces and bounded permissions. The visual station projects the same runtime state the harness can prove. StarNet does not simulate revenue, completed work, model activity, or spend. Its core product law is that the interface must never assert state the harness cannot prove. 模型调用通过本地 Node 侧边程序（sidecar）进行流式传输。工具操作需经过明确的能力和授权检查。智能体的记忆、对话记录、支出记录、任务和调度均持久化存储在磁盘上。多个智能体在独立的工作空间和受限权限下并发运行。可视化空间站所展示的正是框架所能证明的实时运行状态。StarNet 不会模拟收入、已完成的工作、模型活动或支出。其核心产品准则是：界面绝不能断言框架无法证明的状态。

Download

下载

Desktop builds are published on the StarNet releases page. 桌面端构建版本发布在 StarNet 的 Releases 页面。

Platform Asset 平台资源

• Windows (10/11, 64-bit): StarNet_<version>_x64-setup.exe
• macOS — Apple Silicon (M1–M4): StarNet_<version>_aarch64.dmg
• macOS — Intel: StarNet_<version>_x64.dmg

Apple Silicon note: use the native aarch64 DMG. Avoid the x64 DMG on Apple Silicon: it runs under Rosetta 2 rather than using the native architecture. Apple Silicon 注意事项：请使用原生的 aarch64 DMG。在 Apple Silicon 上请避免使用 x64 DMG：它会在 Rosetta 2 下运行，而非使用原生架构。

The public release train supports Windows and macOS. It refuses to stage a release unless the Windows installer passes Authenticode and timestamp verification, both Mac builds pass Developer ID checks and Apple notarization, and every updater artifact has a valid updater signature. Those are pipeline requirements, not proof that a particular downloaded or installed copy was tested on your machine; INSTALL.md explains what to verify and when to stop. 公开版本支持 Windows 和 macOS。除非 Windows 安装程序通过 Authenticode 和时间戳验证、两个 Mac 构建版本通过开发者 ID 检查和 Apple 公证，且每个更新程序工件都具有有效的更新签名，否则系统拒绝发布。这些是流水线要求，并不代表你下载或安装的特定副本已在你的机器上经过测试；请参阅 INSTALL.md 以了解如何验证以及何时停止。

Linux packages are internal build artifacts only and are not a supported public release target. Linux 包仅为内部构建工件，并非受支持的公开发布目标。

Early release: Windows is the most-tested desktop target. macOS has less real-world coverage. Broken? Tell us: androo.agi@gmail.com. 早期版本：Windows 是测试最充分的桌面目标。macOS 的实际覆盖范围较小。遇到问题？请告诉我们：androo.agi@gmail.com。

Run from source

源码运行

Requirements: Node.js 18+ (Node.js 22 matches CI), Git. Rust and the Tauri prerequisites only for the desktop shell. The sidecar uses Node core modules only, so it runs without installing anything: 要求：Node.js 18+（Node.js 22 与 CI 一致），Git。仅桌面外壳需要 Rust 和 Tauri 的先决条件。侧边程序仅使用 Node 核心模块，因此无需安装任何东西即可运行：

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

Open http://localhost:8787, then connect a provider — bring your own OpenRouter API key (BYOK) or use a supported OAuth sign-in. Provider requests leave your machine when you run an agent; station state, transcripts, memory, and ledgers stay in the local StarNet workspace unless you explicitly use a network tool or connector. See PRIVACY.md for the full data map. 打开 http://localhost:8787，然后连接一个服务商——使用你自己的 OpenRouter API 密钥 (BYOK) 或使用支持的 OAuth 登录。当你运行智能体时，服务商请求会离开你的机器；除非你明确使用网络工具或连接器，否则空间站状态、对话记录、记忆和账本都会保留在本地 StarNet 工作空间中。查看 PRIVACY.md 获取完整的数据映射。

Run free with a local model 使用本地模型免费运行 No key, no account, no bill: install Ollama, pull a model (ollama pull llama3.1), and pick OLLAMA as the provider — on the first-run brain screen, or later in SETTINGS → PROVIDERS. StarNet talks to Ollama on 127.0.0.1:11434 and only reports it ready once it can list your local models. Honest caveat: local models are smaller than the cloud ones, so expect slower and rougher work on long tasks. 无需密钥、无需账号、无需付费：安装 Ollama，拉取一个模型（ollama pull llama3.1），并在首次运行的“大脑”界面或稍后的“设置 → 服务商”中选择 OLLAMA 作为服务商。StarNet 会通过 127.0.0.1:11434 与 Ollama 通信，只有在能够列出你的本地模型后才会报告就绪。诚实提醒：本地模型比云端模型小，因此在处理长任务时，速度可能会较慢且效果较粗糙。

For desktop development: 桌面端开发：

npm ci
npm run desktop:dev # dev shell
npm run desktop:build # build installers locally

Coming from OpenClaw or Hermes? StarNet can import an existing agent: point it at your on-disk OpenClaw or Hermes home and it mints a StarNet agent from the persona, instructions, memory, and model it finds. API keys never transfer — you re-enter those in the KEYS tab. 从 OpenClaw 或 Hermes 迁移而来？StarNet 可以导入现有智能体：将其指向你磁盘上的 OpenClaw 或 Hermes 主目录，它会根据发现的个性、指令、记忆和模型创建一个 StarNet 智能体。API 密钥不会迁移——你需要在 KEYS 选项卡中重新输入。

Architecture

架构

Path	Responsibility
frontend/	Vanilla JavaScript station world and desktop UI.
sidecar/	Local Node agent runtime: providers, tools, persistence, budgets, consent.
shared/	Additive cross-boundary event and schema contracts.
src-tauri/	Rust/Tauri desktop shell and bundled runtime.
test/	Unit, contract, integration, and release gates.
qa/	Live QA receipts, journeys, findings ledger, and release-readiness authority.

路径	职责
frontend/	原生 JavaScript 空间站世界和桌面 UI。
sidecar/	本地 Node 智能体运行时：服务商、工具、持久化、预算、授权。
shared/	跨边界的增量事件和模式契约。
src-tauri/	Rust/Tauri 桌面外壳和捆绑运行时。
test/	单元测试、契约测试、集成测试和发布门禁。
qa/	实时 QA 回执、旅程、发现账本和发布就绪性授权。

The frontend consumes real sidecar events over localhost HTTP/NDJSON and SSE. Secrets belong to the local authority: Secrets are held by the sidecar / OS keychain, never in the frontend. 前端通过 localhost HTTP/NDJSON 和 SSE 消费真实的侧边程序事件。密钥属于本地权限：密钥由侧边程序/操作系统钥匙串持有，绝不会出现在前端。

Start with docs/INDEX.md for the living documentation. Older planning documents remain in the repository as design history and a… 从 docs/INDEX.md 开始阅读实时文档。旧的规划文档保留在仓库中作为设计历史和……