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) — 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.
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, or point her at a local model for fully offline), 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.

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