starnet

环境要求

• Node.js 18+（CI 使用 Node.js 22）
• Git
• 仅在构建桌面外壳时需要 Rust 与 Tauri 前置依赖
• 可选：Ollama（想免密钥跑本地模型时安装）

安装与启动步骤

1. 1克隆仓库

   把 starnet 源码下载到本地，确保已安装 Git 且网络可访问 GitHub。

   git clone https://github.com/androoAGI/starnet.git

   复制

2. 2进入项目目录

   切换到刚克隆下来的 starnet 目录，后续命令都在此目录执行。

   cd starnet

   复制

3. 3启动 sidecar 服务

   sidecar 只用 Node 核心模块，无需 npm install，直接运行即可；保持该终端窗口不要关闭。

   node sidecar/index.js

   复制

4. 4浏览器打开界面

   在浏览器访问本地地址，即可看到像素风空间站界面。

   http://localhost:8787

   复制

5. 5连接模型提供商

   在首次运行的 brain 页面粘贴自己的 OpenRouter API Key（BYOK），或使用受支持的 OAuth 登录（Anthropic、OpenAI、Google）；密钥保存在操作系统钥匙串中。

6. 6可选：免费用本地模型

   安装 Ollama 后拉取模型，并在首次运行页面或 SETTINGS → PROVIDERS 中选择 OLLAMA 作为提供商。

   ollama pull llama3.1

   复制

7. 7可选：桌面版开发

   需要构建/调试 Tauri 桌面外壳时，先安装依赖再启动开发外壳或本地打包安装程序。

   npm ci
   npm run desktop:dev
   npm run desktop:build

   复制

关键配置

如何确认成功

浏览器打开 http://localhost:8787 能看到空间站界面；若选 Ollama，能列出本地模型即表示已就绪。

常见问题

注意事项

• Node.js 版本建议 18 以上，与 CI 一致的版本是 Node.js 22。
• 模型密钥存放在操作系统钥匙串中，不会写入前端。
• 该平台执行的是真实模型调用、真实工具和真实成本，不是模拟动画，注意用量与花费。