Anda Bot
English | 简体中文
Born of panda. Awakened as Anda.
Anda Bot is an open-source, local-first AI agent for your computer. It combines long-term memory with tools for working on files, running commands, using a browser, and connecting to external services. You can work with the same agent from Anda Desktop, a Chrome side panel, the terminal, or messaging apps.
The Rust binary, anda, runs a local daemon with an embedded Anda Brain. Conversations, the memory graph, and task state persist on your machine; model requests go to the providers you configure.
Website · Documentation · Downloads
What you can do
- Carry context across conversations. Brain organizes useful preferences, people, projects, and decisions into a knowledge graph. The Memory workspace lets you inspect sources, correct records, stop using them, or preview their deletion.
- Work on extended tasks. The agent can maintain a plan, delegate to subagents, compact context, and continue toward an explicit goal. Runtime skills include workflows for external tools such as Claude Code and Codex.
- Work inside a project. Anda Desktop brings together chat, file previews, Git diffs and commits, recoverable worktrees, interactive terminals, and an embedded browser. The terminal client works from your current directory.
- Connect tools and services. Manage local and remote MCP servers, OAuth connections, tool permissions, resources, and imports from other apps. Other agents can also access Anda's memory through its own MCP endpoint.
- Automate recurring work. Schedule agent prompts or shell commands, inspect their run history, or react to events from MCP servers that support event subscriptions.
- Use different interfaces. Connect Telegram, WeChat, Discord, or Lark/Feishu; inspect image, audio, and video attachments with configured models; enable transcription and speech output separately.
Quick start
Anda Desktop
Download an installer from GitHub Releases:
| Platform | Installer |
|---|
| macOS, Apple Silicon | Anda-mac-arm64.dmg |
| Windows, x64 | Anda-win-x64.exe |
On macOS, you can also use Homebrew:
brew install --cask ldclabs/tap/anda-desktop
Open the app and follow Connect a model: sign in with ChatGPT and select an available model, or choose an API provider preset and enter its key. You can reopen the guide from Settings → General → Connect a model.
Desktop uses an existing anda installation or installs its bundled runtime and skills. It shares the daemon and data with the CLI and Chrome extension when they use the same Anda home. The tray manages the service, login startup, logs, and updates. Release packages do not require Rust, Node.js, or pnpm.
See the desktop guide for workbench controls, packaging, and update behavior. Desktop release packages currently target macOS Apple Silicon and Windows x64; Intel Mac users can build from source.
Command line
Homebrew:
brew install ldclabs/tap/anda
macOS and Linux:
curl -fsSL https://raw.githubusercontent.com/ldclabs/anda-bot/main/scripts/install.sh | sh
Windows PowerShell:
irm https://raw.githubusercontent.com/ldclabs/anda-bot/main/scripts/install.ps1 | iex
CLI releases cover macOS arm64, Linux x86_64/arm64, and Windows x86_64. The scripts install the binary and bundled skills, update PATH, register login startup, and restart the daemon. The shell installer accepts ANDA_NO_AUTOSTART=1 and ANDA_NO_START=1; the downloaded PowerShell script accepts -NoAutostart and -NoStart.
Open a new terminal after installation. If multiple installations exist, check command -v anda on macOS/Linux or Get-Command anda in PowerShell to confirm which one runs.
On a headless Linux machine, Anda needs an available, unlocked Secret Service keyring. For a new installation without one, explicitly run anda user init-file-keys before starting Anda to use file-based identities. This command is not a recovery procedure for an existing installation; see identity setup.
anda
This opens the TUI and starts the daemon if necessary. First launch creates ~/.anda/config.yaml. When no model is configured, Anda exposes setup controls; the agent, Brain, channels, and cron become available after model setup.
Connect a model
Choose ChatGPT sign-in or a model provider API key.
ChatGPT sign-in
anda auth login chatgpt
anda
The CLI signs in through your browser and selects the first available model; add --model <model-slug> to choose one explicitly. Use anda auth accounts, anda auth models <profile-id>, and anda auth use <profile-id> <model-slug> to manage the selection. The TUI also offers sign-in with Ctrl+G.
ChatGPT plan connections use their own encrypted credentials, without an API key. While a ChatGPT plan provider is enabled, the daemon accepts only the local owner for agent requests, excluding other trusted users and external IM senders. Speech and attachment-processing capabilities may need separate providers. Use anda auth login chatgpt --no-browser --port 1455 with an SSH tunnel for headless sign-in.
API provider
Edit the generated config.yaml, or use Settings → Agent configuration in Desktop. The bundled configuration contains provider presets. A minimal example using its default preset is:
model:
active: "deepseek-flash"
providers:
- family: anthropic
model: "deepseek-flash"
api_base: "https://api.deepseek.com/anthropic"
api_key: "YOUR_API_KEY"
labels: ["memory"]
stream: true
disabled: false
This is the beginning of the README. Read the rest at the original. Read the full README ↗
