install on macOS

Install Mirror Mind first. Then add Mirror Desktop.

Mirror Desktop is a local app for an existing Mirror Mind installation. Start with Mirror Core, verify it through your AI runtime, then install the macOS alpha.

Prepare the tools

You need Git, uv, OpenRouter credits, and an AI runtime. Pi is the recommended runtime because it can use Codex through a Codex Plus subscription.

curl -LsSf https://astral.sh/uv/install.sh | sh
curl -fsSL https://pi.dev/install.sh | sh

Install Mirror Core

Clone the framework and let uv create the local Python environment.

git clone https://github.com/mirror-mind-ai/mirror.git
cd mirror
uv sync

Configure your mirror

Create `.env`, set your Mirror user and OpenRouter key, then initialize and seed your local identity.

cp .env.example .env
uv run python -m memory init your-name
uv run python -m memory seed

Verify your mirror

Open your AI runtime inside the `mirror` directory and speak naturally. For example, open Pi with `pi`, or open Claude Code or Codex from the same directory, then ask:

list my journeys
list my personas
show my Mirror Mind commands
help me think through an idea using Mirror Mind

Install Mirror Desktop

After Mirror Core is working, download the macOS alpha. Open the DMG, copy Mirror Desktop where you want it, then connect it to your local Mirror installation.

Private macOS alpha. Signed update channel, not notarized yet. macOS may require right click, Open, then confirmation.

Download Mirror Desktop for macOS