starnet README

The project's README from github.com/androoAGI/starnet. As one markdown file: README.md.

StarNet

A living pixel-art station where real AI agents do real work.

Download Platforms License: MIT Local-first

Download · Install guide · Run from source · Docs · Contributing

The StarNet station — rooms, crew, and workstations rendered from live harness state

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.

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.
Message it from anywhere Wire agents to Telegram, Discord, Slack, Signal, or Matrix and talk to your station away from the desk.
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.
Asks before it guesses Task Briefs turn ambiguity into one concrete question with options — over any connected channel — instead of a silent wrong guess.
Finished work has a front door Deliverables land in the OUTBOX as real files you open, not chat scrollback you archaeology.
MCP connectors Attach Model Context Protocol servers and paste-a-key/OAuth connectors to extend what agents can touch.
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

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.

Download

Desktop builds are published on the StarNet releases page.

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.

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. Linux packages are internal build artifacts only and are not a supported public release target.

Early release: Windows is the most-tested desktop target. macOS has less real-world coverage. Broken? Tell us: [email protected].

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:

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.

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.

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.

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.

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.

Start with docs/INDEX.md for the living documentation. Older planning documents remain in the repository as design history and are labeled accordingly.

Testing

npm run test:fast          # required merge gate
npm run test:http          # live sidecar HTTP/E2E suite
npm test                   # validation + world + fast + HTTP suites
npm run security:secrets   # full-history secret scan; requires Gitleaks in PATH

The release aggregate is npm run qa:ready. It is candidate-bound: any new commit invalidates the prior READY receipt until the affected live gates are rerun.

Contributing and security

Contributions are welcome — read CONTRIBUTING.md and follow the Code of Conduct.

Do not report vulnerabilities in a public issue. Follow SECURITY.md for private reporting instructions.

License

StarNet is open source under the MIT License. Third-party components remain under their original licenses — see NOTICE.md.

The MIT License covers the code only. The StarNet name, the logo, the station artwork and sprites, and the rest of the project's brand identity are owned by Andrew Sims and are not licensed with it — no trademark or other brand rights are granted, expressly or by implication.

MIT means you may fork, modify, and redistribute the code, including commercially. What you may not do is ship it as StarNet: forks and derivatives must use their own name, logo, and artwork, and must not present themselves as this project or as endorsed by it.

starnet (androoAGI/starnet)

Searching Database…

1.5K ·GitHub
Что это?StarNet — десктопная среда с подходом «сначала локальные данные», где вы создаёте ИИ-агентов, размещаете их на пиксельной космической станции и видите, как они реально выполняют работу с настоящими моделями и инструментами; схема станции — живая проекция реального состояния рантайма, а не украшение.
Станция — это просто декоративный интерфейс или она что-то означает?Карта — это настоящая модель разрешений: комната — команда с ограниченным набором возможностей, коридор — авторизованная линия передачи задач, а любой размещённый объект — реальная выдача возможности; раскладка, которую вы рисуете, буквально является workflow, который выполняют агенты.
Как это запустить?Скачайте готовый установщик для десктопа со страницы релизов (Windows x64-setup.exe, macOS aarch64.dmg для Apple Silicon или macOS x64.dmg для Intel) или запускайте из исходников с Node.js 18+ и Git (Rust и зависимости Tauri нужны только для сборки десктопной оболочки).
Нужен ли API-ключ для работы?Не обязательно — можно использовать свой ключ OpenRouter или войти через Anthropic, OpenAI или Google, но можно и работать полностью бесплатно, установив Ollama, скачав локальную модель и выбрав OLLAMA в качестве провайдера.
Готово ли это к запуску на Linux или только Windows и macOS?Поддерживаемые публичные релизы выходят только для Windows и macOS; сборки под Linux — лишь внутренние артефакты, а не целевая поставка. Это и ранний релиз: Windows — наиболее протестированная настольная цель, а macOS покрыта хуже.
Могу ли я связаться с агентами, когда меня нет за компьютером?Да — можно подключить агентов к Telegram, Discord, Slack, Signal или Matrix и писать станции удалённо, а режим Night Shift позволяет агентам продолжать работу без присмотра в настраиваемых и логируемых рамках.
Куда на самом деле уходят мои API-ключи и данные агентов?Запросы к провайдерам покидают вашу машину при работе агента, но секреты хранятся в связке ключей/sidecar ОС и никогда не попадают во фронтенд, а состояние станции, расшифровки, память и журналы остаются в локальном рабочем пространстве, если вы не используете сетевой инструмент или коннектор.
Можно ли сделать форк и выпустить свою версию под собственным брендом?Код под лицензией MIT: его можно форкать, изменять и распространять (включая коммерчески), но имя StarNet, логотип, арт станции и фирменный стиль не покрываются лицензией, поэтому форки должны использовать собственное название и графику и не выдавать себя за StarNet.
Что происходит, когда агент не знает, что делать?Вместо того чтобы молча угадывать, Task Briefs в StarNet превращают неопределённость в один конкретный вопрос с вариантами, отправленный по любому подключённому каналу, так что решение принимаете вы, прежде чем работа продолжится.
Куда попадают готовые результаты работы агентов?Готовые результаты попадают в OUTBOX как настоящие файлы, которые можно открыть напрямую, а не тонут в истории чата, которую пришлось бы разгребать.
Можно ли перенести агентов из OpenClaw или Hermes?Да — укажите StarNet на существующий домашний каталог OpenClaw или Hermes, и он создаст нового агента StarNet из найденных персоны, инструкций, памяти и модели, но API-ключи никогда не переносятся, их нужно ввести заново.
Как расширить то, к чему агент имеет доступ?Можно подключить серверы Model Context Protocol (MCP) и коннекторы с вставкой ключа или OAuth, чтобы дать агентам доступ к дополнительным инструментам и сервисам сверх встроенных возможностей.
What are similar projects?brigade, evenfire, holaOS, hive, turnstone, 1code, laya, openworker
Creator
androoAGI
Size
1.8 GB
Stars
1.5K
Age
4mo
Commits · 90 Days