> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mira-app.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# macOS Installation

> Install MIRA on macOS 12 Monterey or later — Apple Silicon (arm64).

## Requirements

| Requirement       | Detail                                            |
| ----------------- | ------------------------------------------------- |
| **macOS version** | 12 Monterey or later                              |
| **Architecture**  | Apple Silicon (arm64) — M1, M2, M3, M4            |
| **Python**        | Bundled — no separate install needed              |
| **LLM provider**  | One 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](https://github.com/satyendra2013/mira-app/releases/latest) and download:

* **Apple Silicon (M1/M2/M3/M4):** `MIRA-x.x.x-arm64.dmg`

<Tip>
  Not sure which chip you have? Go to **Apple menu → About This Mac**. If it says "Apple M" you have
  Apple Silicon.
</Tip>

## Install

<Steps>
  <Step title="Open the DMG">
    Double-click the downloaded `.dmg` file. A Finder window opens showing the MIRA icon and an
    Applications folder shortcut.
  </Step>

  <Step title="Drag to Applications">
    Drag the **MIRA** icon onto the **Applications** folder shortcut. Wait for the copy to
    complete.
  </Step>

  <Step title="Launch MIRA">
    Open **Launchpad** or **Spotlight** (⌘Space) and search for "MIRA". Click to launch.
  </Step>

  <Step title="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.
  </Step>
</Steps>

## 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/`

<Note>
  MIRA stores credentials in `credentials.json` inside its data folder (encrypted using macOS
  Keychain-backed safeStorage). Deleting the data folder removes all credentials.
</Note>

## 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](https://github.com/satyendra2013/mira-app/releases/latest) to download the latest `.dmg` and repeat the install steps above.

***

<Note>
  **Edit this page** — [Open a pull
  request](https://github.com/satyendra2013/mira-app/edit/main/docs/get-started/installation/macos.mdx)
  to improve these instructions.
</Note>