Configuration du runtime

Anda stocke son état dans ~/.anda par défaut. Le fichier principal est ~/.anda/config.yaml. La configuration MCP optionnelle se trouve dans ~/.anda/mcp.json.

Fournisseurs de modèles

Le fournisseur actif doit inclure family, model et api_base. api_key peut être dans le fichier ou venir d'une variable d'environnement.

model:
  active: "deepseek-v4-pro"
  providers:
    - family: anthropic
      model: "deepseek-v4-pro"
      api_base: "https://api.deepseek.com/anthropic"
      api_key: "YOUR_API_KEY"
      labels: ["pro", "brain"]
      disabled: false

Variables supportées :

OPENAI_API_KEY
ANTHROPIC_API_KEY
GEMINI_API_KEY
GOOGLE_API_KEY
DEEPSEEK_API_KEY
MINIMAX_API_KEY
MIMO_API_KEY
MOONSHOT_API_KEY
KIMI_API_KEY
BIGMODEL_API_KEY
GLM_API_KEY

Réglages principaux

Réglage	But
addr	Adresse gateway locale, par défaut 127.0.0.1:8042.
sandbox	Si true, shell passe par ~/.anda/sandbox.
https_proxy	Proxy pour modèles et canaux.
model	Fournisseurs pour agent et mémoire.
transcription	Transcription voix et audio.
tts	Lecture vocale.
channels	Telegram, WeChat, Discord, Lark/Feishu.

Serveurs MCP

Anda Bot peut se connecter à des serveurs MCP via des processus stdio ou des endpoints HTTP. Placez une configuration MCP portable dans ~/.anda/mcp.json, puis redémarrez le daemon. Le fichier accepte mcpServers et servers comme root key afin de coller des configurations venant d'autres outils MCP avec peu de changements.

{
  "mcpServers": {
    "filesystem": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "$ANDA_WORKSPACE"]
    },
    "remote": {
      "type": "http",
      "url": "https://mcp.example.com/mcp",
      "headers": {
        "Authorization": "Bearer ${MCP_REMOTE_TOKEN}"
      }
    }
  }
}

Les outils MCP distants apparaissent comme des outils Anda nommés mcp_<server_id>_<remote_tool>. Les chaînes de configuration prennent en charge l'expansion $VAR et ${VAR}. ANDA_HOME et ANDA_WORKSPACE sont intégrées. Pour les serveurs stdio, command est lancé directement sans shell ; si cwd est omis, le premier workspace Anda est utilisé. Si type est omis, Anda infère stdio depuis command ou http depuis url.

L'agent peut aussi ajouter un serveur au moment de l'exécution avec add_mcp_server. Utilisez persist: false uniquement pour le daemon courant, ou persist: true pour enregistrer le serveur dans ~/.anda/mcp.json et le conserver après les redémarrages. Ses champs de serveur reflètent une entrée mcp.json : type, command, args, env, cwd, url, headers, enabled, include et exclude, plus les champs propres à l'outil id et persist.

Dossiers locaux

~/.anda/
  config.yaml
  mcp.json
  channels/
  db/
  keys/
  logs/
  bundled-skills/
  sandbox/
  skills/
  skills-manifest.json
  skill-backups/
  skill-trash/
  workspace/

db/ contient mémoire, conversations, états de canaux et cron. bundled-skills/ contient les skills gérées par les mises à jour d'Anda, tandis que skills/ contient les skills personnelles créées, clonées ou modifiées par l'utilisateur. skills-manifest.json conserve l'état local d'activation, de désactivation et de rechargement ; skill-backups/ et skill-trash/ conservent les sauvegardes avant édition et les skills personnelles supprimées. workspace/ est l'espace par défaut pour shell et fichiers.

Confidentialité

Les données locales restent sur votre machine, mais les fournisseurs de modèles peuvent recevoir prompts, résumés et requêtes de mémoire. Choisissez fournisseurs, endpoints et proxy selon vos besoins.

astuce

Utilisez anda --home /path/to/.anda pour isoler projets, identités ou tests.