Getting Started with ZeroSphere

Welcome to ZeroSphere. This guide walks you through everything you need to know once you have access.

Add Your API Keys

ZeroSphere is BYOK. You pay your model provider directly at cost. We take nothing.

Go to Settings > AI > API Keys and paste your keys for the providers you want to use:

Provider	Key name
Anthropic (Claude)	`ANTHROPIC_API_KEY`
OpenAI	`OPENAI_API_KEY`
Google Gemini	`GEMINI_API_KEY`
Tavily (web search)	`TAVILY_API_KEY`

Restart ZeroSphere after saving. Your models will appear in the model selector immediately.

Open a Project

Launch ZeroSphere and open your project folder:

File > Open Folder or Ctrl + O

Run Your First Agent Task

Open the agent panel with Ctrl + E.

Type what you want built:

"Add authentication to the login route and test that it works"

ZeroSphere will:

Write the code
Compile the project
Launch your app in a virtual display
Click through the UI flow
Catch what breaks and fix it

You watch it happen. You do not touch anything.

Permissions

ZeroSphere asks before acting outside expected scope. You can:

Approve per action: review everything
Always allow for operations you trust
Revoke mid-session to stop the agent at any point

Every action is visible in the virtual display in real time.

Configuration

Settings are managed via Settings in the UI. The underlying files are:

Windows:

%APPDATA%\Roaming\zerosphere-nightly\
├── settings.toml    # Editor and UI settings
├── config.toml      # Agent permissions
└── .env             # API keys

Project-specific overrides (optional, can be committed to version control):

your-project/.zerosphere/settings.toml

Project settings take priority over user settings.

Troubleshooting

Agent not responding? Restart ZeroSphere. If the issue persists, check Settings > AI to confirm your API key is saved and the correct model is selected.

Permission errors? Check Settings > AI > Permissions and verify the operation is allowed.

Questions? support@zerosphere.dev