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

# Installation

> Install Mirage with the Python package mirage-ai or the TypeScript packages @struktoai/mirage-node and @struktoai/mirage-browser.

## Prerequisites

* **Python** ≥ 3.11 for the `mirage-ai` package and the `mirage` CLI
* **Node.js** ≥ 20 for the TypeScript SDK
* **macOS** or **Linux** (FUSE-based mounts require platform support)

## Python

```bash theme={null}
uv add mirage-ai
```

This installs both the `mirage` library and the `mirage` CLI binary.

## TypeScript

Pick the package that matches your runtime — `@struktoai/mirage-core` is auto-pulled by both Node and browser entrypoints.

```bash theme={null}
npm install @struktoai/mirage-node      # Node.js servers and CLIs
npm install @struktoai/mirage-browser   # browser / edge runtimes
npm install @struktoai/mirage-agents    # OpenAI / Vercel AI / LangChain / Mastra adapters
```

## CLI

```bash theme={null}
curl -fsSL https://strukto.ai/mirage/install.sh | sh
# or
npm install -g @struktoai/mirage-cli
# or
uvx mirage-ai
# or
npx @struktoai/mirage-cli
```

## More Details

<CardGroup cols={2}>
  <Card title="Python" icon="https://mintcdn.com/struktoai/F9Lv_nTaj6By6crk/images/python-logo.svg?fit=max&auto=format&n=F9Lv_nTaj6By6crk&q=85&s=cf5b268d330f7db46ea5cf6083f309a1" href="/python/install" width="110" height="110" data-path="images/python-logo.svg">
    Resource extras, virtualenv setup, and `uv` workflow.
  </Card>

  <Card title="TypeScript" icon="https://mintcdn.com/struktoai/F9Lv_nTaj6By6crk/images/typescript-logo.svg?fit=max&auto=format&n=F9Lv_nTaj6By6crk&q=85&s=63a620cb702b16103c53ea361a17504a" href="/typescript/install" width="512" height="512" data-path="images/typescript-logo.svg">
    Native peers (FUSE, Redis) and per-runtime notes for Node, browser, and edge.
  </Card>
</CardGroup>