Skip to main content

​
Requirements

RequirementDetail
DistributionUbuntu 20.04+, Fedora 36+, or any modern x64 Linux
Architecturex64 (amd64)
PythonBundled — no separate install needed
LLM providerOne of: AWS Bedrock, Anthropic, OpenAI, or Ollama
Disk space~500 MB (includes bundled Python runtime)
keychain backendlibsecret (GNOME) or KWallet (KDE) for secure credential storage

​
Download

Go to github.com/satyendra2013/mira-app/releases/latest and download one of:
  • MIRA-x.x.x-x64.AppImage — runs on any x64 Linux, no install required
  • mira_x.x.x_amd64.deb — Debian/Ubuntu system install
  • mira-x.x.x-x86_64.rpm — Fedora/RHEL/openSUSE system install

​
Install

# Make executable and run — no install, no root required
chmod +x MIRA-x.x.x-x64.AppImage
./MIRA-x.x.x-x64.AppImage
To add to your application launcher, place the AppImage in ~/.local/bin/ and create a .desktop file, or use AppImageLauncher.

​
Credential storage on Linux

MIRA uses libsecret to store secrets (API keys, AWS credentials) in your system keyring:
  • GNOME: GNOME Keyring (installed by default on Ubuntu, Fedora GNOME)
  • KDE: KWallet
If neither is available (e.g. on a headless or minimal install), credentials fall back to an encrypted file. Ensure libsecret is installed: 
# Ubuntu / Debian
sudo apt-get install libsecret-1-0

# Fedora
sudo dnf install libsecret

​
First launch

MIRA performs a one-time setup on first launch:
  • Creates a Python virtual environment at ~/.config/MIRA/mira-venv/
  • Installs all required Python packages from the bundled requirements.txt
A splash screen is displayed during this step (~60 seconds). The status bar shows NAE starting… → NAE ready when complete.

​
Data location

All MIRA data is stored locally at: 
~/.config/MIRA/
├── mira.db          ← sessions, skills, workflows, settings
├── evals.db         ← evaluation runs and results
├── credentials.json ← encrypted credentials (libsecret/safeStorage)
├── mira-venv/       ← Python environment
└── logs/            ← application logs (credentials redacted)

​
Uninstall

# AppImage — delete the file and optionally the data directory
rm ~/path/to/MIRA-x.x.x-x64.AppImage
rm -rf ~/.config/MIRA/

# Deb package
sudo apt-get remove mira
rm -rf ~/.config/MIRA/    # removes data and credentials (not done by package manager)

# RPM package
sudo dnf remove mira      # Fedora
sudo rpm -e mira          # RHEL/openSUSE
rm -rf ~/.config/MIRA/    # removes data and credentials

​
Updating

MIRA checks for updates shortly after launch. When a new version is available, an in-app notification shows the available version number. Go to github.com/satyendra2013/mira-app/releases/latest to download the latest AppImage, .deb, or .rpm and install as above.
Edit this page — Open a pull request to improve these instructions.