Repolode
Submit
androoAGI

androoAGI/starnet

A local-first desktop app where you build pixel-art AI agents that run real model calls and tools with your own API key.

View on GitHubWebsite
Stars
1,750
Forks
351
Open issues
65
Last commit
7 days ago

What is it?

StarNet is a desktop agent harness for creating AI agents, grouping them into a pixel-art space station, and running them against real models and tools. Each agent gets its own workspace, transcript, memory, and bounded permissions, and several can run concurrently. The station view is driven by live runtime state, so the layout reflects which agents are actually working.

Models are accessed bring-your-own-key through OpenRouter, or through supported provider sign-ins for Anthropic, OpenAI, and Google. Keys are stored in the OS keychain and kept out of the frontend. Agents can also run on a local Ollama model for free, though local models are smaller and slower on long tasks.

The project includes a terminal companion command, `starnet`, for listing agents, approving or denying tool requests, and running one-off tasks. It is built with Tauri, a Node.js sidecar, and vanilla JavaScript, and is currently most tested on Windows, with macOS builds also published.

Key features

  • 01Create agents with distinct personas and loadouts, and run several at once with separate workspaces.
  • 02Connect models through OpenRouter or supported provider sign-ins, with keys kept in the OS keychain.
  • 03Run agents on a local Ollama model without a cloud account.
  • 04Persist transcripts, memory, spend records, tasks, and schedules on disk.
  • 05Attach MCP servers to extend the tools agents can use.
  • 06Control agent tool access with explicit capability and consent checks.
  • 07Use a `starnet` terminal command to monitor agents and answer approval requests.

Use cases

  • Running several AI agents on separate tasks while keeping each one's permissions and history isolated.
  • Using your own OpenRouter key to try different models without a subscription.
  • Running agents against a local Ollama model when you want data to stay on your machine.
  • Monitoring and approving agent tool calls from a terminal.

Quick start

  1. 1

    Clone the repository

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

    Enter the project folder

    cd starnet
  3. 3

    Start the sidecar (no dependencies to install)

    node sidecar/index.js
  4. 4

    Open http://localhost:8787 in your browser and connect a provider (your own OpenRouter key or a supported sign-in)

Things to know

  • Early release: Windows is the most-tested desktop target, and macOS has less real-world coverage.
  • Running agents requires your own provider API key or a local model such as Ollama.

In collections

Open-source AI agent frameworks & appsPrivacy & local-first toolsDesktop GUI apps & toolkits

Topics

#ai-agents#llm#agent-harness#desktop-app#local-first#multi-agent#openrouter#tauri#ai#byok

FAQ

What is starnet?
A local-first desktop app where you build pixel-art AI agents that run real model calls and tools with your own API key. StarNet is a desktop agent harness for creating AI agents, grouping them into a pixel-art space station, and running them against real models and tools. Each agent gets its own workspace, transcript, memory, and bounded permissions, and several can run concurrently. The station view is driven by live runtime state, so the layout reflects which agents are actually working.
Is starnet free to use? What license does it have?
starnet is open source under the MIT license. Check the license terms before using it in commercial products.
Is starnet still maintained?
Actively maintained. The last commit to starnet was on Oct 31, 2026.
What can I use starnet for?
Running several AI agents on separate tasks while keeping each one's permissions and history isolated. Using your own OpenRouter key to try different models without a subscription. Running agents against a local Ollama model when you want data to stay on your machine. Monitoring and approving agent tool calls from a terminal.
How do I install starnet?
Clone the repository: git clone https://github.com/androoAGI/starnet.git Enter the project folder: cd starnet Start the sidecar (no dependencies to install): node sidecar/index.js Open http://localhost:8787 in your browser and connect a provider (your own OpenRouter key or a supported sign-in)
Where can I get starnet?
The source code and installation instructions are on GitHub: https://github.com/androoAGI/starnet

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects