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

# Install the CLI

> Install the autosana command-line tool

The `autosana` CLI connects local simulators, emulators, physical devices, and dev servers to Autosana so you can run flows against a build on your own machine. It also validates your code-managed flow files offline before you push (`autosana flows validate`).

## Quick install

The fastest way — installs [uv](https://docs.astral.sh/uv/) if it's missing, then the CLI. Zero prerequisites:

```bash theme={null}
curl -fsSL https://get.autosana.ai | sh
```

Re-run it any time to upgrade.

## Other install methods

<Tip>
  On a Mac and already using Homebrew? `brew install autosana/tap/autosana` is the most familiar path.
</Tip>

**Homebrew:**

```bash theme={null}
brew install autosana/tap/autosana
```

**pipx:**

```bash theme={null}
pipx install autosana
```

**uv:**

```bash theme={null}
uv tool install autosana
```

**pip** (into an environment you manage):

```bash theme={null}
pip install "autosana>=0.8.0"
```

<Note>
  The `autosana flows` commands (validate/export) require **version 0.8.0 or newer**. Older installs won't have them.
</Note>

## Verify

```bash theme={null}
autosana --version
```

If `autosana` isn't found after installing with uv, add uv's tool directory to your PATH and restart your shell:

```bash theme={null}
uv tool update-shell
```

## Set up prerequisites

Local device testing needs Node.js, Appium, and a tunnel. The CLI installs and checks them for you:

```bash theme={null}
autosana doctor        # report what's missing
autosana doctor --fix  # auto-install Node.js + Appium + cloudflared
```

## Upgrading

```bash theme={null}
curl -fsSL https://get.autosana.ai | sh   # or:
uv tool upgrade autosana
pipx upgrade autosana
brew upgrade autosana
```

## Next steps

* [Run flows locally →](/local-testing)
* [Write effective flows →](/flows)