All docs
Guide
Getting started in 3 minutes
Three steps. Install, paste an LLM key, describe your first test. The first-run wizard inside the app walks you through everything; this page is the quick-reference for if you want to know what's about to happen before you click Download.
1
Install
Grab the right installer from the Download page. First launch will trigger a Gatekeeper or SmartScreen warning on macOS / Windows — that's because Beta builds aren't yet signed. Bypass once and your OS remembers.
2
Onboard
Six steps inside the app: Welcome → Privacy → Permissions → LLM key → First-run tour → Done. The whole wizard takes about a minute and only asks for things you actually need.
3
Paste your LLM key
Orbis is Bring Your Own Key — your API key goes straight to your provider, encrypted on your laptop in the OS keychain. Orbis never sees it.
- Anthropicbest planner quality. Sonnet is the default.
- Geminigreat for vision-checks. 2.0 Flash is cheap and fast.
- OpenAIGPT-5/4o family. Solid planner alternative.
- DeepSeek / xAI / Mistralcompetitive options at lower cost.
- Ollamafully local, no internet needed for the LLM.
4
Describe your first scenario
Open the Scenarios tab → + New scenario. Give it a title, the site domain, and two-to-three sentences describing what to test:
Go to https://app.example.com/login. Sign in as qa@example.com / hunter2. Confirm the dashboard greeting shows "Welcome back".
5
Hit Run
Watch the Live Run tab. Each step streams with a screenshot, the model's reasoning, the action it took, and a pass/fail for each assertion. When the run finishes you'll get a self-contained HTML report you can zip and share.
Pro tip
Set a cost cap per run in Settings → Run before you point Orbis at production. A few cents is plenty for a smoke test; this stops a runaway scenario from draining your LLM key.