Skip to main content

Install Anda

Anda Bot can be installed from a release or run directly from the repository source. Releases are best for daily use; source builds are best for contribution, debugging, and experimenting with new features.

Install the Latest Release​

On macOS, Homebrew is recommended:

brew install ldclabs/tap/anda

On macOS, the Homebrew formula installs both anda and anda_launcher. Run anda_launcher once to start the menu bar launcher and refresh ~/Applications/Anda Bot.app.

macOS and Linux can also use the install script:

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

Windows users should download AndaBotSetup-windows-x86_64.exe from the latest release and double-click it. The installer places Anda under %LOCALAPPDATA%\Programs\AndaBot, installs curated skills, creates Start Menu and desktop shortcuts, registers the tray launcher to start at login, starts the launcher, opens a GUI setup wizard for provider/API key/model, and checks for downloaded updates that can be installed with a restart prompt.

Advanced users and CI can still use PowerShell:

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

The macOS shell installer also installs ~/Applications/Anda Bot.app, registers the menu bar launcher at login, and starts it immediately; the launcher starts the daemon after setup, can check for updates from the menu bar, and prompts to install and restart after an update is downloaded. Linux shell installs register daemon autostart directly. For PowerShell, add -NoAutostart or -NoStart to opt out; for the shell installer, set ANDA_NO_AUTOSTART=1 or ANDA_NO_START=1.

After installation, open a new terminal and run:

anda

Prepare a Model API Key​

You need at least one model provider API key. Windows installer users can enter it in the setup wizard. CLI users can start with an environment variable:

DEEPSEEK_API_KEY=YOUR_API_KEY anda

Windows PowerShell：

$env:DEEPSEEK_API_KEY="YOUR_API_KEY"; anda

You can also write the key to ~/.anda/config.yaml for reuse. The api_key in config.yaml takes priority over environment variables.

First Launch​

On first run, Anda creates the local runtime directory and ~/.anda/config.yaml. If the configuration is incomplete, the terminal UI lists the missing fields.

  1. Open ~/.anda/config.yaml.
  2. Fill in the model provider family, model, api_base, and either api_key or an environment variable.
  3. Save the file.
  4. Refresh models from the launcher or browser side panel, or run anda models reload.

Minimal model configuration:

model:
  active: "deepseek-v4-pro"
  providers:
    - family: anthropic
      model: "deepseek-v4-pro"
      api_base: "https://api.deepseek.com/anthropic"
      api_key: "YOUR_API_KEY" # Can be empty when DEEPSEEK_API_KEY is set
      labels: ["pro", "brain"]
      disabled: false

The brain label makes the memory brain prefer that provider. If no provider has the label, memory tasks use the active model.

Run from Source​

To run directly from the repository:

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

Use a separate home directory to isolate identities, projects, or test data:

anda --home /path/to/.anda

Equivalent source command:

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

Update​

If installed through the install script, update with:

anda update

Manage the background daemon with:

anda status
anda start
anda stop
anda restart
anda autostart status