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

# Download & Install stagewise

> Download the stagewise agentic IDE for macOS (Apple Silicon & Intel), Windows (64-bit), or Linux. Get started with AI coding agents on your desktop in minutes.

stagewise is a native desktop agentic IDE — not a web app or browser extension. Download it once and AI coding agents work directly on your filesystem.

## Before you begin

* A macOS, Windows, or Linux machine meeting the requirements below
* Optional: a stagewise account for instant access to the managed model library. You can also [bring your own API keys](/reference/byok-setup) or [run models locally](/reference/custom-providers)

## Step 1: Download stagewise

Download the latest version from [stagewise.io](https://stagewise.io).

| Platform    | Requirements                                                        | Download                                            |
| ----------- | ------------------------------------------------------------------- | --------------------------------------------------- |
| **macOS**   | macOS 12 (Monterey) or later · Apple Silicon (arm64) or Intel (x64) | DMG from [stagewise.io](https://stagewise.io)       |
| **Windows** | Windows 10 or later · 64-bit (x64)                                  | Installer from [stagewise.io](https://stagewise.io) |
| **Linux**   | Ubuntu 20.04+, Debian 11+, or compatible · x64                      | AppImage from [stagewise.io](https://stagewise.io)  |

## Step 2: First launch & onboarding

When you first open stagewise, an onboarding wizard walks you through three steps:

1. **Welcome** — Introduction to the open source agentic IDE
2. **Authentication** — Sign in with your stagewise account (email + one-time password) or skip to use your own keys
3. **Feature walkthrough** — Guided overview of workspaces, slash commands, @mentions, design previews, and plugins

## Step 3: Sign in or skip

You don't need an account to use stagewise. Pick what works for you:

* **Sign in with email** — Passwordless OTP authentication. Gets you instant access to the stagewise Account model library — a curated set of pre-configured models ready to use. No API keys needed.
* **Import your subscriptions** — Already paying for Claude, GPT, Gemini, Kimi, Qwen, DeepSeek, GLM, or MiniMax? Bring your existing API keys and use them directly. [Set up BYOK →](/reference/byok-setup)
* **Go fully local** — Run models entirely on your machine via Ollama or LM Studio. Zero external API calls, full data sovereignty. [Connect a custom endpoint →](/reference/custom-providers)

## Step 4: Connect a workspace first

stagewise works best after you connect a project folder. The agent needs workspace access before it can read files, edit code, run commands, or review diffs.

You can browse without a workspace, but coding workflows start with a connected folder.

## What's next

<CardGroup cols={2}>
  <Card icon="wand-magic-sparkles" href="/getting-started/quickstart" title="Quickstart">
    Connect a workspace and send your first prompt in under 5 minutes.
  </Card>

  <Card icon="brain" href="/core-concepts/how-agents-work" title="How agents work">
    Understand the agent loop and how AI coding agents operate on your code.
  </Card>
</CardGroup>