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

# Windows Installation

> Install MIRA on Windows 10 or later — x64.

## Requirements

| Requirement         | Detail                                            |
| ------------------- | ------------------------------------------------- |
| **Windows version** | 10 or later (x64)                                 |
| **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:

**`MIRA-Setup-x.x.x-x64.exe`**

## Install

<Steps>
  <Step title="Run the installer">
    Double-click `MIRA-Setup-x.x.x-x64.exe`. **No administrator rights are required** for a
    per-user install.

    If Windows SmartScreen shows a blue warning dialog, click **More info → Run anyway**. This
    appears because MIRA is distributed from GitHub — it is not malware.
  </Step>

  <Step title="Follow the installer steps">
    Accept the licence agreement, choose your install location (default: `%LOCALAPPDATA%\Programs\MIRA`), and click **Install**.
  </Step>

  <Step title="Launch MIRA">
    MIRA starts automatically after install. You can also find it in the **Start Menu** or
    via the **Desktop** shortcut.
  </Step>
</Steps>

## First launch

MIRA performs a one-time setup on first launch:

* Creates a Python virtual environment at `%APPDATA%\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:

```
%APPDATA%\MIRA\
├── mira.db          ← sessions, skills, workflows, settings
├── evals.db         ← evaluation runs and results
├── credentials.json ← encrypted credentials (DPAPI)
├── mira-venv\       ← Python environment
└── logs\            ← application logs (credentials redacted)
```

To open this folder quickly, press **Win+R**, type `%APPDATA%\MIRA`, and press Enter.

## Credentials storage

API keys and AWS credentials are encrypted using **Windows DPAPI** (Data Protection API) and stored in `credentials.json` inside the MIRA data folder. DPAPI ties encryption to your Windows user account — no separate password is required and no entries are created in Windows Credential Manager.

## Uninstall

1. Go to **Settings → Apps → Installed apps**
2. Find **MIRA** and click **Uninstall**
3. To remove all data and credentials: delete `%APPDATA%\MIRA\`

## 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 installer and run it over the existing installation.

***

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