---
title: Installation
description: Install Mirage with the Python package mirage-ai or the TypeScript packages @struktoai/mirage-node and @struktoai/mirage-browser.
keywords: ["install Mirage", "mirage-ai", "@struktoai/mirage-node", "virtual filesystem", "AI agents"]
icon: download
---

## 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
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
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
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="/images/python-logo.svg" href="/python/install">
    Resource extras, virtualenv setup, and `uv` workflow.
  </Card>
  <Card title="TypeScript" icon="/images/typescript-logo.svg" href="/typescript/install">
    Native peers (FUSE, Redis) and per-runtime notes for Node, browser, and edge.
  </Card>
</CardGroup>
