安装 Anda

Anda Bot 可以通过发布版安装，也可以直接从仓库源码运行。发布版适合日常使用；源码运行适合贡献代码、调试或试验新功能。

安装最新发布版

macOS 推荐使用 Homebrew：

brew install ldclabs/tap/anda

在 macOS 上，Homebrew formula 会同时安装 anda 和 anda_launcher。运行一次 anda_launcher 即可启动菜单栏 launcher，并刷新 ~/Applications/Anda Bot.app。

macOS 和 Linux 也可以使用安装脚本：

curl -fsSL https://raw.githubusercontent.com/ldclabs/anda-bot/main/scripts/install.sh | sh

Windows 普通用户请从 latest release 下载 AndaBotSetup-windows-x86_64.exe，然后双击安装。安装器会把 Anda 安装到 %LOCALAPPDATA%\Programs\AndaBot，安装内置 skills，创建开始菜单和桌面快捷方式，注册托盘 launcher 登录自启，安装完成后立即启动 launcher，并打开 GUI 向导完成 provider/API key/model 配置；launcher 还会自动检查并下载更新，下载完成后提示安装并重启。

高级用户和 CI 仍可使用 PowerShell：

irm https://raw.githubusercontent.com/ldclabs/anda-bot/main/scripts/install.ps1 | iex

macOS shell 安装器也会安装 ~/Applications/Anda Bot.app，为菜单栏 launcher 注册登录自启，并立即启动 launcher；launcher 会在完成配置后启动 daemon，也可以从菜单栏检查更新，并在更新下载完成后提示安装并重启。Linux shell 安装仍直接注册 daemon 自启。PowerShell 安装器可以用 -NoAutostart 或 -NoStart 退出默认行为；shell 安装器可以设置 ANDA_NO_AUTOSTART=1 或 ANDA_NO_START=1。

安装完成后打开一个新的终端，并运行：

anda

准备模型 API key

至少需要一个模型 provider API key。Windows 安装器用户可以在 GUI 向导中填写；CLI 用户可以先用环境变量启动：

DEEPSEEK_API_KEY=YOUR_API_KEY anda

Windows PowerShell：

$env:DEEPSEEK_API_KEY="YOUR_API_KEY"; anda

也可以把 key 写进 ~/.anda/config.yaml，供后续会话复用。config.yaml 中的 api_key 优先级高于环境变量。

首次启动

第一次运行时，Anda 会创建本地运行目录和 ~/.anda/config.yaml。如果配置还不完整，终端 UI 会列出缺失字段。

打开 ~/.anda/config.yaml。
填好 model provider 的 family、model、api_base，以及 api_key 或环境变量。
保存文件。
在 launcher 或浏览器侧边栏点击刷新模型，或运行 anda models reload。

最小模型配置示例：

model:
  active: "deepseek-v4-pro"
  providers:
    - family: anthropic
      model: "deepseek-v4-pro"
      api_base: "https://api.deepseek.com/anthropic"
      api_key: "YOUR_API_KEY" # 设置 DEEPSEEK_API_KEY 时可留空
      labels: ["pro", "brain"]
      disabled: false

brain 标签会让记忆大脑优先使用这个 provider。没有 provider 带这个标签时，记忆任务会使用当前 active model。

从源码运行

如果你想直接从仓库运行：

git clone https://github.com/ldclabs/anda-bot.git
cd anda-bot
cargo run -p anda_bot --

使用独立 home 目录可以隔离身份、项目或测试数据：

anda --home /path/to/.anda

源码运行时等价命令是：

cargo run -p anda_bot -- --home /path/to/.anda

更新

通过安装脚本安装的发布版可以这样更新：

anda update

可以这样管理后台 daemon：

anda status
anda start
anda stop
anda restart
anda autostart status

安装最新发布版​

准备模型 API key​

首次启动​

从源码运行​

更新​

安装最新发布版

准备模型 API key

首次启动

从源码运行

更新