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

# Install Avibe

> Install Avibe on macOS, Linux, or Windows with WSL.

# Install Avibe

Avibe runs locally on the machine where your data and coding agents live.

## macOS and Linux

```bash theme={null}
curl -fsSL https://avibe.bot/install.sh | bash
```

Open source — [view the script on GitHub](https://github.com/avibe-bot/avibe/blob/master/install.sh) or [audit it before running](#audit-before-running). The short URL is a 307 redirect to that file.

Verify the install:

```bash theme={null}
vibe version
vibe doctor
```

Start the service and setup wizard:

```bash theme={null}
vibe
```

## Windows

The recommended Windows path is WSL:

* Use Windows for your browser and chat apps.
* Use Ubuntu in WSL for Avibe, agent CLIs, and your code repository.

From Ubuntu in WSL:

```bash theme={null}
curl -fsSL https://avibe.bot/install.sh | bash
vibe
```

Native PowerShell installation is available, but WSL is usually smoother for Python, Node, Git, and coding agent CLIs:

```powershell theme={null}
irm https://raw.githubusercontent.com/avibe-bot/avibe/master/install.ps1 | iex
```

## Audit before running

Prefer to read the script before piping it to `bash`? Fetch it locally first, inspect it, then run it:

```bash theme={null}
curl -fsSL https://avibe.bot/install.sh -o install.sh
cat install.sh           # or: less install.sh
bash install.sh
```

`https://avibe.bot/install.sh` is a 307 redirect to the same file on GitHub raw, so both URLs serve identical content.

## What the installer does

The installer:

* Installs the `vibe` CLI.
* Uses PyPI first and falls back to GitHub when needed.
* Prints PATH guidance if the command is installed but not visible in the current shell.
* Leaves your chat platform credentials and agent credentials for the setup wizard.

## Upgrade

Re-run the installer:

```bash theme={null}
curl -fsSL https://avibe.bot/install.sh | bash
```

## Uninstall

Only remove local state if you no longer need your Avibe configuration:

```bash theme={null}
vibe stop
uv tool uninstall avibe-os
uv tool uninstall vibe-remote  # legacy installs
rm -rf ~/.avibe ~/.vibe_remote
```