After installing Qorven, this guide takes you from opening the URL to having your first real conversation. 5 minutes. No Postgres, no YAML, no CLI.

1. Open the UI

The installer prints a URL like https://192.168.1.42:443 or https://localhost. Open it.
First load shows a browser warning because Qorven’s local CA isn’t trusted on your laptop yet. Either:
  1. Click through the warning once (the cert is real, your machine just doesn’t know the CA)
  2. Or run sudo qorven tls install-ca once — the warning never appears again. Full TLS guide →

2. Sign in

If this is a fresh install you’ll see the setup wizard. Otherwise: paste the auth token the installer printed.
Qorven login screen

3. Meet Prime

Prime is your Chief of Staff Qor — the agent that takes your requests and delegates them to the right specialist. Every Qorven install has a Prime; you don’t create it.
Chat with Prime Qor
Ask anything:
  • “What’s the status of my projects?”
  • “Draft an email to the team about Thursday’s offsite”
  • “Look up flights from Bangalore to Singapore next Friday”
  • “Read this PDF and summarise the findings”

4. Watch the delegation

Prime rarely does the work itself. It delegates:
Delegation card
1

You ask Prime a question

Text, voice, screen share — all work. Prime reads your message with your preferences and any relevant memory already loaded.
2

Prime picks a specialist or spawns one

If there’s already a Researcher, Coder, or Email Qor, Prime sends them a task. If not, Prime calls manage_agents and creates one on the fly.
3

Specialists work in parallel

Each specialist is its own Qor with its own tools, memory, and workspace. They can talk to each other in rooms when the task needs coordination.
4

Prime reports back

You see the final answer. The specialist’s full trace — every tool call, every draft — is in the audit log if you need to inspect it.

5. Try a few signature features

Send from another channel

Connect Telegram. Message your Qor from your phone. The same conversation appears in the web UI — one Qor, one chat.

Search memory mid-chat

Click the 🧠 button above the composer. Search anything you’ve told this Qor. Click a result to drop it into the composer as context.

Share your screen

Toolbar → Share screen. Your Qor sees what you see (1 frame/sec, never persisted, 30-second TTL).

Open the live browser

Toolbar → Live browser. Watch your Qor browse the web in real time. Great for demoing what it’s doing.

What’s actually happening under the hood

Where next

Customise Prime

Edit the system prompt, swap the model, change the tools Prime can use.

Create your own Qor

A Qor per role — Researcher, Email Triage, Standup Bot, Reporter.

Next-steps menu

10 things to try in your first hour.

Add your LLM keys

Bedrock, OpenAI, Anthropic, DeepSeek, Gemini, Groq, Ollama.