Install & first task

// from download to your first working agent

1. Download and install

Download StarNet for Windows or macOS from the releases page:

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

Open the installer and follow its steps. If SmartScreen shows "Windows protected your PC", Open More info, verify the publisher matches the release notes, and proceed only then.

macOS first run

1. Open the .dmg and drag StarNet into Applications.
2. Open StarNet from Applications.

If Gatekeeper reports an unknown developer, missing notarization, or a damaged app, stop and report the release tag and asset name. Do not clear quarantine for a purported public release.

2. Connect a provider

First launch has two setup steps: choose your agent’s identity, then connect its model. Use a StarNet account, a supported provider sign-in, an API key, or a local model. The models and providers reference explains each option.

Select a model before continuing. Your provider or local model must be available for the agent to answer.

3. Send your first task

Your first crew member is the Overseer. Talk to it in COMMS, the station’s chat window.

1. Finish the introduction and open your agent’s COMMS conversation.
2. Send a small request, such as “Give me a three-item checklist for planning my week.”
3. Wait for the completed response. If the provider returns an error, check your model connection before trying a larger task.

That is enough to start using StarNet. When you want work to pass through several agents, follow Build your first workflow. To give your crew more tools, see Set up your crew.

4. Updates

Use the desktop app’s Update Center to check for and install updates. If an update cannot complete, follow the troubleshooting guide and note the version and error shown.

Run from source

For a development checkout, install Node.js 18 or later, then run:

git clone https://github.com/androoAGI/starnet.git
cd starnet
npm install
npm start
# open http://localhost:8787

Keep that terminal running while you use the station. The desktop installer is the simpler path if you do not need a source checkout. For speech setup and fallbacks, see Agents, teams & voice.