GETTING STARTED

// from download to your first working agent

1. Download and install

Windows and macOS installers are fully supported from day one. Linux ships from the same signed release train. Grab the right build from the 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`
Linux — Debian / Ubuntu	`StarNet_<version>_amd64.deb`
Linux — anything else	`StarNet_<version>_amd64.AppImage`

Not sure which Mac you have? Apple menu → About This Mac. "Apple M…" means Apple Silicon; "Intel" means Intel. The wrong one won't run.

Windows first run

The installer is Authenticode code-signed. While the certificate is new, SmartScreen may still show "Windows protected your PC" — click More info → Run anyway. The installer then runs normally.

macOS first run

Open the .dmg and drag StarNet into Applications.
Open StarNet once — macOS blocks it the first time (the app isn't notarized yet).
Approve it: System Settings → Privacy & Security, scroll to Security, click Open Anyway — or on older macOS, right-click the app → Open → Open.

You only do this once; afterwards StarNet opens normally.

Linux

# Debian / Ubuntu
sudo apt install ./StarNet_<version>_amd64.deb

# any distro
chmod +x StarNet_<version>_amd64.AppImage
./StarNet_<version>_amd64.AppImage

2. Connect a provider

On first launch StarNet asks for one model provider. An OpenRouter API key works everywhere (hundreds of models through one key), or use a supported OAuth sign-in. Details in Providers & keys.

3. Awaken your first agent

The onboarding flow walks you through recruiting your first crew member: a short interview shapes its dossier, it takes a desk in your station, and you give it its first task from the COMMS window. When it uses a real tool you'll see it move to the workstation that grants that tool — the animation is driven by the actual run, not a script.

4. Updates

StarNet updates itself (System → Updates). Every update is cryptographically verified against a key baked into the app before it installs — on every platform, independent of OS code-signing. You never need to re-download installers for routine updates.

Run from source

The sidecar runs on Node core modules alone — no npm install needed:

git clone https://github.com/androoAGI/starnet.git
cd starnet
node sidecar/index.js
# open http://localhost:8787

NEXT: PROVIDERS & KEYS →