mirror mind

install on Linux

Install Mirror Mind Core on Linux.

Linux can run Mirror Mind through the supported AI runtimes. Mirror Desktop for Linux is not distributed from the site yet.

Prepare the tools

Install Git, uv, OpenRouter credits, and the AI runtime you want to use. Pi is the recommended runtime.

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

Install Mirror Core

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

Configure your mirror

Create `.env`, set `MIRROR_USER` and `OPENROUTER_API_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 Pi, Claude Code, or Codex inside the `mirror` directory and interact in natural language:

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

About Mirror Desktop

Linux Desktop distribution is not part of the public alpha yet. Use Mirror Mind through your runtime for now.