> ## 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.

# 安装 Avibe

> 在 macOS、Linux 或 Windows WSL 上安装 Avibe。

# 安装 Avibe

Avibe 运行在你的数据和编码 Agent 所在的机器上。

## macOS 和 Linux

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

开源脚本，源码在 [GitHub](https://github.com/avibe-bot/avibe/blob/master/install.sh) 上；如果想先审计再安装，看下面的"审计后再安装"小节。该短链只是到这个文件的 307 重定向。

验证安装：

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

启动服务和设置向导：

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

## Windows

Windows 推荐使用 WSL：

* Windows 负责浏览器和聊天 App。
* WSL 里的 Ubuntu 负责 Avibe、Agent CLI 和代码仓库。

在 WSL 的 Ubuntu 里运行：

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

也可以使用原生 PowerShell 安装，但对 Python、Node、Git 和编码 Agent CLI 来说，WSL 通常更顺：

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

## 审计后再安装

想在执行前先读一下脚本？先把它下到本地、看一遍再执行：

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

`https://avibe.bot/install.sh` 是到 GitHub raw 文件的 307 重定向，两个 URL 的内容完全一致。

## 安装脚本做什么

安装脚本会：

* 安装 `vibe` CLI。
* 优先使用 PyPI，必要时回退到 GitHub。
* 如果命令已安装但当前 shell 不可见，会打印 PATH 指引。
* 把聊天平台凭证和 Agent 凭证留给设置向导处理。

## 升级

重新运行安装脚本：

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

## 卸载

只有在不再需要 Avibe 配置时才删除本地状态：

```bash theme={null}
vibe stop
uv tool uninstall avibe-os
uv tool uninstall vibe-remote  # 旧版安装
rm -rf ~/.avibe ~/.vibe_remote
```