> ## Documentation Index
> Fetch the complete documentation index at: https://struktoai-fix-databricks-volume-token-provider.mintlify.site/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 via your package manager of choice:

```bash theme={null}
npm install -g @struktoai/mirage-cli
```

```bash theme={null}
npx @struktoai/mirage-cli
```

```bash theme={null}
uvx mirage-ai
```

## More Details

<CardGroup cols={2}>
  <Card title="Python" icon="https://mintcdn.com/struktoai-fix-databricks-volume-token-provider/L29HQXdXZnKHBlaU/images/python-logo.svg?fit=max&auto=format&n=L29HQXdXZnKHBlaU&q=85&s=dbb1acf31edb69679757b0a0f72a0e7c" 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-fix-databricks-volume-token-provider/L29HQXdXZnKHBlaU/images/typescript-logo.svg?fit=max&auto=format&n=L29HQXdXZnKHBlaU&q=85&s=6c79cbd74bb1e10eec604f935fc674ee" 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>