Linux Installation

Requirements

Requirement	Detail
Distribution	Ubuntu 20.04+, Fedora 36+, or any modern x64 Linux
Architecture	x64 (amd64)
Python	Bundled — no separate install needed
LLM provider	One of: AWS Bedrock, Anthropic, OpenAI, or Ollama
Disk space	~500 MB (includes bundled Python runtime)
keychain backend	`libsecret` (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

AppImage (any distro)
Debian / Ubuntu (.deb)
Fedora / RPM (.rpm)

# 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.

# Install
sudo dpkg -i mira_x.x.x_amd64.deb

# Fix any missing dependencies
sudo apt-get install -f

# Launch
mira

# Fedora
sudo dnf install mira-x.x.x-x86_64.rpm

# RHEL / openSUSE
sudo rpm -i mira-x.x.x-x86_64.rpm

# Launch
mira

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.

Get Started

Core Concepts

Features

Eval Framework

Configuration

Developer Guide

Community

Reference

Linux Installation

Requirements

Download

Install

Credential storage on Linux

First launch

Data location

Uninstall

Updating

​Requirements

​Download

​Install

​Credential storage on Linux

​First launch

​Data location

​Uninstall

​Updating

Requirements

Download

Install

Credential storage on Linux

First launch

Data location

Uninstall

Updating