Skip to main content

​
Requirements

RequirementDetail
macOS version12 Monterey or later
ArchitectureApple Silicon (arm64) — M1, M2, M3, M4
PythonBundled — no separate install needed
LLM providerOne of: AWS Bedrock, Anthropic, OpenAI, or Ollama
Disk space~500 MB (includes bundled Python runtime)

​
Download

Go to github.com/satyendra2013/mira-app/releases/latest and download:
  • Apple Silicon (M1/M2/M3/M4): MIRA-x.x.x-arm64.dmg
Not sure which chip you have? Go to Apple menu → About This Mac. If it says “Apple M” you have Apple Silicon.

​
Install

1

Open the DMG

Double-click the downloaded .dmg file. A Finder window opens showing the MIRA icon and an Applications folder shortcut.
2

Drag to Applications

Drag the MIRA icon onto the Applications folder shortcut. Wait for the copy to complete.
3

Launch MIRA

Open Launchpad or Spotlight (⌘Space) and search for “MIRA”. Click to launch.
4

Handle Gatekeeper (first launch only)

If macOS shows “MIRA cannot be opened because the developer cannot be verified”:
  1. Open System Settings → Privacy & Security
  2. Scroll to the security notice about MIRA
  3. Click Open Anyway
  4. Confirm with your password or Touch ID
This prompt appears for apps downloaded from the internet. It only appears on the first launch.

​
First launch

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

​
Data location

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

​
Uninstall

  1. Drag MIRA from Applications to Trash
  2. To remove all data and credentials: delete ~/Library/Application Support/MIRA/
MIRA stores credentials in credentials.json inside its data folder (encrypted using macOS Keychain-backed safeStorage). Deleting the data folder removes all 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 .dmg and repeat the install steps above.
Edit this page — Open a pull request to improve these instructions.