Getting started

Set up Mimir, step by step

About ten minutes, from download to your first answer.

Every picture below is a real screen from Mimir. Follow along in order; each step says where to find it again later.

1Install Mimir

Get the installer for your computer from the download section: Windows 10 or 11, or a Mac (Apple silicon or Intel).

From then on Mimir tells you when a new version is out, with a gold pill in the status bar, and installs it with one click.

2Make your Mimir account

The first time Mimir opens, it asks for your email and sends you an eight-digit code. There is no password. Type the code, and you are in.

Your first account on a computer comes with 1,000 free credits (a dollar of DeepSeek V4), so you can start talking without finding a key. Write down the recovery key Mimir shows you once; it is how you get back in if none of your computers is at hand.

Mimir's account step: Make your Mimir account, with an email box and an Email me a code button.
The account step. Your email, then a code.

3Choose who answers

Next, Mimir asks which AI to use. Pick one card:

Mimir's setup screen: Choose your source of wisdom, with cards for Anthropic, OpenAI, OpenRouter, DeepSeek, Qwen and Custom, and an API key box with a Connect button.
Choose your source of wisdom. You can add more providers later in Settings → Engine.

4Tell Mimir about you

Mimir asks three things: what to call you, what you mainly use it for, and how it should speak to you. Each can be skipped. It keeps the answers so it knows you from the first chat.

Mimir's greeting: You have found the Well, with a box asking What shall I call you?
Three questions. Settings → General holds the answers.

5Take the tour

Then a short guide walks through the window, one part at a time, with that part lit up: the message box, the model picker, your workspace, the approval card, your phone, and reporting bugs. It takes about a minute. Settings → Tidings → Open the setup guide shows it again whenever you like.

The setup guide's first page: Your Well is ready, with a drawing of Mimir's window and Next and Skip the tour buttons.
The setup guide. Seven short pages, each with a picture.

6Your first chat

Type what you want in the box at the bottom and press Enter. Mimir can read and write files in your workspace, run commands and search, and it shows each step as it works. A few things worth knowing:

Mimir's main window: sessions and artifacts on the left, the golden eye in the middle with the words The Well is still, a message box at the bottom and the status bar below it.
The Well. Chats on the left, the conversation in the middle, the model at the top right.

The picker at the top right changes the model for the chat you are in. Providers you have not connected say Connect.

The model picker open over the window, listing Mimir credits models and Anthropic models, each provider with a Connect button.
The model picker. Search, switch, or connect another provider.

Settings, at the bottom of the sidebar, is where everything else lives: Engine for providers and keys, Agent for permissions, Phone for pairing, Wallet for credits and spend, Appearance for themes.

Mimir's Settings with the Engine tab open: the active model, a list of models, and API key boxes for Anthropic and OpenAI.
Settings → Engine. Add a key or sign in with a plan at any time.

7Say yes, or no

Reading is always allowed. Before Mimir writes a file or runs a command, it asks, and nothing happens until you say Allow. Running commands, looking at your screen and moving your mouse also stop at your operating system's own dialog, where No is the default.

When you trust it with a kind of action, turn that switch on in Settings → Agent and Mimir stops asking for it. Commands that delete or overwrite still ask on their own.

Mimir's Permissions settings: autonomous work, file writes, shell commands, web access, screen sight and desktop control, each switched off.
Settings → Agent. Every switch starts off.

8Pair your phone

With the Mimir app on your phone you can talk to your agents and your desktop chats while you are away. Your computer does the work; the phone is the window.

  1. On your computer, open Settings → Phone and press Pair a phone. A code and a QR code appear for a few minutes.
  2. In the Mimir app, choose to pair and scan the QR code, or type the code.
  3. Keep Mimir running on the computer. If the phone says the link is down, Mimir on the computer is closed: open it, and the phone finds it again.
A drawing from the setup guide: Settings, Phone, Pair a phone with a QR code, and a phone with the Mimir app scanning it.
Pairing. One scan, and the phone stays paired.

9Report every bug

Mimir is young, and it grows from what you tell us. If anything looks wrong, feels slow, confuses you or just seems off, please report it. A one-line report is plenty, and small things count too. Every report is read.

  1. Press report at the bottom right of the window.
  2. Say in a sentence what you did and what happened.
  3. Press Send report. Mimir's version, the model, what it was doing and its error log go along by themselves.
The Report a bug card: a box saying I clicked an artifact in the sidebar and nothing opened, with Cancel and Send report buttons.
Report a bug. A sentence is enough.

Mimir can also report its own errors. Leave Send error reports automatically on (the setup guide asks, and Settings → Tidings has the switch), and every five minutes Mimir checks its error log and sends any new error to us. Reports go through your Mimir account with names, emails, IP addresses and the paths of your folders taken out, and they never carry your chats or your files. The privacy page says exactly what is sent.

The last page of the setup guide: Help Mimir grow, report every bug, with the Send error reports automatically switch ticked.
The guide's last page. The automatic reports switch, on.

Not signed in, or no Mimir on hand? Open an issue on GitHub and say what you did and what you saw. A screenshot helps.

That's it

You are set up. Ask Mimir anything; it is glad of the work.

Download Mimir