Vexillon

Install

Up and running
in minutes.

One line installs MIRA on Linux, macOS or Windows, runs a guided setup, and registers her as a background service. Prefer containers? Docker is one command too.

Linux macOS Windows WSL Docker
A machine to run it onLinux, macOS, Windows — or anywhere Docker runs. A small always-on box (home server, mini PC, VPS) is ideal: MIRA is a long-running service and is lightweight by design.
An LLM providerAn API key (Anthropic, OpenAI, OpenRouter, DeepSeek, Gemini, OpenCode Go) — or a local OpenAI-compatible server (LM Studio, Ollama, llama.cpp) for fully offline. You set this during the wizard and can change it later.
A few minutesMIRA bundles everything else — web UI, database, and voice models fetched on demand. No extra services to stand up.

On your phone

Get the MIRA app

Reach your MIRA server from anywhere — download the app, point it at your server (or scan the pairing QR), and you're connected. No server yet? Try the live demo first — no signup, nothing to install.

Download on the App Store Coming soon toGoogle Play
QR code to download MIRA on the App Store Scan with your phone's camera to download
1

Install her

The one-line installer detects your platform, downloads the matching signed release, verifies its checksum, and puts the mira binary on your PATH — no sudo needed. On Linux or macOS:

Linux / macOS
$ curl -fsSL https://get.vexillon.ai/install.sh | sh

On Windows (PowerShell):

PowerShell
> irm https://get.vexillon.ai/install.ps1 | iex

Pin a specific version by passing --version:
curl -fsSL https://get.vexillon.ai/install.sh | sh -s -- --version X.Y.Z

2

Finish the guided setup

The installer launches MIRA's mira setup wizard automatically — you'll create your admin account, choose your AI model (bring your own key, point her at a local model for fully offline, or pick Custom (OpenAI-compatible) to connect any endpoint with just a base URL and key — your own gateway, proxy, or remote server), and set a couple of security options. Then it registers MIRA as a background service so your OS keeps her running and restarts her on reboot, and opens the web UI at http://localhost:8080. No config files to hand-edit.

3

Bring in the rest of the family

Add channels anytime under Settings → Channel Accounts — a Telegram or Discord token, a Signal number, an email account. Each person can link their own, or share one household bot, so MIRA reaches everyone where they already chat.

4

Back it up & keep it current

Everything lives in one data directory. Use the one-click (optionally encrypted) backup in Settings → Server, or just copy the folder. Updating is one command — it fetches the latest signed release and restarts the service:

upgrade
$ mira upgrade
✓ MIRA updated and restarted

Other ways to install

Docker

MIRA ships a Dockerfile and docker-compose.yml. From a checkout of the repo, bring the stack up — it mounts ./data (your whole install) and restarts on reboot.

docker
$ docker compose up -d
# custom port:
$ MIRA_PORT=9090 docker compose up -d

Manual binary

Rather not pipe a script to your shell? Download the release for your platform, put mira on your PATH, then run the same steps by hand:

manual
$ mira setup     # admin, model, security
$ mira install   # register the service

Full details — data directory, system-wide service, and troubleshooting — are in the installation guide.

Removing MIRA

Uninstall

MIRA is self-contained — one binary, one background service, and one data directory — so removing it is three steps:

uninstall
$ mira uninstall            # stop & remove the background service
$ rm "$(command -v mira)"   # remove the binary from your PATH
$ rm -rf ~/.mira            # remove all data: config, databases, logs, secrets

The last step erases everything MIRA stored — conversations, memories, and your encrypted secrets vault — and can't be undone, so back up ~/.mira first if you might want any of it. If you chose a custom --data-dir, remove that folder instead. A system-wide install (mira install --system) needs sudo for the service and binary steps. Docker: docker compose down stops and removes the container; delete the mounted ./data folder to erase your install.

Prefer to build from source?

MIRA is written in Rust (edition 2024, Rust 1.85+). Clone the repo and cargo build --release. The full developer setup, channel guides and architecture docs live in the repository.

Read the docs on GitHub

Welcome her in.

Free, open source, and yours. The whole household, one quiet helper.

Star on GitHub Star on GitHub