0 12 0

<!-- generated by iii-skill-render. DO NOT EDIT (changes here are overwritten on the next render). Edit docs/0-12-0/install.mdx. -->

# Install


{/* TODO (community feedback): Add a direct binary-download path alongside the curl|sh installer so users who do not want to verify a remote script with a bot, or are on Windows, have an alternative. Link to the GitHub Releases page for the engine and include PATH setup instructions per OS (especially Windows). */}

## 1. Install iii

Install the iii engine:

```bash
curl -fsSL https://install.iii.dev/iii/main/install.sh | sh
```

## 2. Verify installation

Check that iii has installed correctly with the following command. It should return a version
number.

```bash
iii --version
```

<Info title="Engine and SDK versions">
  The engine and SDK packages can have different patch versions within the same minor line. Keep the
  engine and SDKs on the same minor version, for example `0.11.x`, unless a release note says
  otherwise.
</Info>

{/* TODO: re-enable the "## 3. Install the VS Code Extension (Optional)" section once the iii-lsp extension is more thoroughly tested across VS Code, Cursor, Windsurf, and VSCodium. The Frame demo also needs `/images/lsp.mp4` to be captured and committed before the section is re-added. ## 3. Install the VS Code Extension (Optional) The iii Language Server extension gives your editor live awareness of your iii project: - **Completions**: function IDs, trigger types, payload properties, and known values like stream names and API paths. - **Hover documentation**: request and response schemas for any registered function. - **Diagnostics**: validates function IDs, required payload fields, trigger configs, cron expressions, and HTTP methods as you type. Works with TypeScript, Python, and Rust files. Requires a running iii engine. <Frame> <video autoPlay loop muted playsInline src="/images/lsp.mp4" alt="iii Language Server in action: completions, hover docs, and diagnostics" /> </Frame> Open the Extensions panel and search for `iii-lsp`, or install from the terminal: <Tabs> <Tab title="VS Code"> code --install-extension iii-hq.iii-lsp </Tab> <Tab title="Cursor"> cursor --install-extension iii-hq.iii-lsp </Tab> <Tab title="Windsurf"> windsurf --install-extension iii-hq.iii-lsp </Tab> <Tab title="VSCodium"> codium --install-extension iii-hq.iii-lsp </Tab> </Tabs> */}

{/* TODO: re-add a "## 4. Add Agent Skills (Optional)" section with `npx skillkit add iii-hq/iii/skills` once the iii skills worker ships (owned by Sergio). */}

## Next Steps

<CardGroup cols={2}>
  <Card title="Quickstart" href="./quickstart" icon="terminal">
    Follow the Quickstart and explore a live iii application.
  </Card>
  <Card title="Use iii" href="./using-iii" icon="table-layout">
    Learn how to use iii in production.
  </Card>
</CardGroup>