Installation

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

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.

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

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

Python

Resource extras, virtualenv setup, and uv workflow.

TypeScript

Native peers (FUSE, Redis) and per-runtime notes for Node, browser, and edge.

Introduction CLI

Getting Started

Learn

Help

Setup

FUSE

Prerequisites

Python

TypeScript

CLI

More Details

Python

TypeScript

​Prerequisites

​Python

​TypeScript

​CLI

​More Details

Python

TypeScript

Prerequisites

Python

TypeScript

CLI

More Details