StarNet Help Download ↓

Troubleshooting

// every warning documented honestly, every fix spelled out

Windows: "Windows protected your PC"

The public train requires Authenticode publisher and timestamp verification, but SmartScreen can still flag a certificate while it builds reputation. Click More info, verify the publisher matches the release notes, and proceed only then. Stop if the publisher is unknown.

macOS: "cannot be opened" / "is damaged"

A public release is required to carry a Developer ID signature and stapled Apple notarization ticket. This warning is therefore a trust failure, not an expected first-run step. Stop and report the release tag, asset name, Mac architecture, macOS version, and exact warning. Do not clear quarantine or use an unsigned-app override for a purported public release.

Updates

The built-in updater (System → Updates) supports Windows and both Mac architectures and verifies every update against a key baked into the app. This is independent of Authenticode, Developer ID signing, and notarization. The build contract is not installed-update evidence; report a failed update and use the matching current release installer when necessary.

The station browser will not load pages

If every page fails, agents report proxy or connection errors, or a new browser "exits before it can be controlled", an earlier StarNet session may have left its browser running. Open Settings → BROWSER → RESET STATION BROWSER. It closes the station browser, ends any copy an earlier StarNet session left running on the station profile, and clears that profile's stale locks. It never touches your own Chrome, and your saved sign-ins are kept. Agents can do the same thing themselves with the browser.reset tool. StarNet also does this check on its own before it starts the station browser.

If an agent is using the browser at that moment, stop the run first. If the reset reports a process it could not end, quit StarNet from the tray and restart your computer.

Erase everything and start over

Uninstalling removes only the program. Your station lives in a separate folder for your user account, so a reinstall picks it right back up. To really start from scratch, open Settings → APP & BACKUP → ERASE EVERYTHING, type ERASE, and click twice. StarNet stops, deletes everything it keeps on this computer, and restarts at first run. When it finishes it lists exactly what it removed, and anything it could not remove.

It deletes your station, agents, chats, memory, routines and settings, saved browser sign-ins, files agents saved inside StarNet, logs, the voice-model download, the keys and tokens StarNet saved in your system keychain, and the app window's own stored data. It also turns off Launch at login.

It does not touch project folders you let agents work in, files exported to StarNet deliverables, your Downloads folder, your StarNet account and its credits (this computer is just unlinked from it), or the StarNet app itself. Export a backup first (EXPORT STATION, same page) if you might want any of it back.

Want a clean station but keep the old one on disk? Use START FRESH on the recovery screen instead: it moves the old station to a quarantine folder rather than deleting it.

Where StarNet keeps your data

Quit StarNet first (tray icon → Quit), or it will recreate files while you delete them. Then remove these by hand if you cannot use ERASE EVERYTHING:

In Finder, press Cmd+Shift+G and paste a ~/Library/... path to open it. In Windows, paste a %APPDATA% path into the File Explorer address bar.

Uninstalling

Uninstalling keeps your station data. To remove that too, run ERASE EVERYTHING before you uninstall, or delete the folders listed in Where StarNet keeps your data.

Behind a VPN or corporate proxy

The app window honors your system proxy, but the engine's own outbound connections — AI providers and messaging channels like Discord — go out directly and do not route through a proxy (Telegram is the one exception: it honors HTTPS_PROXY / ALL_PROXY). On a network that forces one, the UI and browser sign-ins can look perfectly healthy while runs and channel connects fail with a plain network error. There is no proxy setting yet; you need direct access to the provider and platform APIs. COPY DIAGNOSTICS (under any failed turn) shows whether a proxy is configured on your machine.

Live Voice is slow to start the first time

Expected, once. Hands-free Live Voice runs on a speech engine inside the app rather than a cloud service, so the first session downloads the open Whisper and Kokoro model weights and caches them in your user profile — the panel shows that download's progress instead of pretending to listen. Once cached, local listening needs no network. Speaking stays local while Kokoro is available; otherwise StarNet may use the keyless Microsoft Edge Read Aloud fallback for answer text. If the panel refuses before opening your microphone, neither the local packages nor a supported offline operating-system dictation fallback is available.

Still stuck?

Open an issue on GitHub or email androo.agi@gmail.com. We'd rather hear about a broken thing than have you assume it's supposed to be that way.