Getting started
Three steps. Install, add a key, write a scenario. The first run wizard inside the app walks you through everything in detail.
1. Install
Grab the right installer from the download page. First launch may show a security warning on macOS or Windows. Approve once and the OS remembers.
2. Add an LLM key
Open Settings, pick a provider, paste your key. The key is encrypted in your OS keychain. Orbis never sees it.
- Anthropic. Sonnet is the default planner.
- Google Gemini. 2.0 Flash is cheap and fast for vision.
- OpenAI, DeepSeek, xAI, Mistral, OpenRouter.
- Ollama for fully local runs.
3. Write your first scenario
Open the Scenarios tab and click New scenario. Give it a title and write three short sentences:
Go to https://app.example.com/login. Sign in as qa@example.com / hunter2. Confirm the dashboard greeting shows "Welcome back".
4. Run it
Hit Run and watch the Live Run view. Each step streams with a screenshot, the reasoning, the action taken, and a pass or fail for each assertion. When it finishes you get a self-contained HTML report.
Tip
Set a cost cap in Settings before pointing Orbis at production. A few cents is plenty for a smoke test and it stops a runaway scenario from draining your key.