Saltar al contenido principal

Instalar Anda

Anda Bot se puede instalar desde una versión publicada (release) o ejecutar directamente desde el código fuente del repositorio. Las versiones publicadas son ideales para el uso diario; las compilaciones desde el código fuente son recomendables para contribuciones, depuración y experimentación con nuevas funciones.

Instalar la última versión​

En macOS, se recomienda utilizar Homebrew:

brew install ldclabs/tap/anda

En macOS, la fórmula de Homebrew instala tanto anda como anda_launcher. Ejecute anda_launcher una vez para iniciar el lanzador de la barra de menús y actualizar ~/Applications/Anda Bot.app.

En macOS y Linux también se puede utilizar el script de instalación:

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

Los usuarios de Windows deben descargar AndaBotSetup-windows-x86_64.exe desde la última versión lanzada y hacer doble clic en él. El instalador coloca a Anda bajo %LOCALAPPDATA%\Programs\AndaBot, instala las habilidades (Skills) preseleccionadas, crea accesos directos en el Escritorio y en el Menú de inicio, registra el lanzador de la bandeja del sistema para que se inicie al iniciar sesión, inicia el lanzador, abre un asistente de configuración gráfico para configurar el proveedor, la clave API y el modelo, y busca actualizaciones descargadas que puedan instalarse mostrando un aviso de reinicio.

Los usuarios avanzados y los entornos de Integración Continua (CI) pueden utilizar PowerShell:

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

El instalador de shell para macOS también instala ~/Applications/Anda Bot.app, registra el lanzador de la barra de menús al iniciar sesión y lo inicia de inmediato; el lanzador inicia el daemon después de la configuración, puede buscar actualizaciones desde la barra de menús y solicita instalar y reiniciar una vez descargada la actualización. Las instalaciones de shell en Linux registran directamente el inicio automático del daemon. Para PowerShell, añada -NoAutostart o -NoStart para omitir este comportamiento; para el instalador de shell, defina ANDA_NO_AUTOSTART=1 o ANDA_NO_START=1.

Después de la instalación, abra una nueva terminal y ejecute:

anda

Preparar una clave API del modelo​

Necesita al menos una clave API de proveedor de modelos. Los usuarios del instalador de Windows pueden introducirla en el asistente de configuración. Los usuarios de la interfaz de línea de comandos (CLI) pueden comenzar configurando una variable de entorno:

DEEPSEEK_API_KEY=TU_CLAVE_API anda

En Windows PowerShell:

$env:DEEPSEEK_API_KEY="TU_CLAVE_API"; anda

También puede escribir la clave en ~/.anda/config.yaml para reutilizarla. La clave api_key en config.yaml tiene prioridad sobre las variables de entorno.

Primer lanzamiento​

En la primera ejecución, Anda crea el directorio de runtime local y el archivo ~/.anda/config.yaml. Si la configuración está incompleta, la interfaz de usuario de la terminal mostrará la lista de campos faltantes.

  1. Abra ~/.anda/config.yaml.
  2. Complete los campos family, model, api_base y api_key o use una variable de entorno para el proveedor del modelo.
  3. Guarde el archivo.
  4. Actualice los modelos desde el lanzador o el panel lateral del navegador, o ejecute anda models reload.

Configuración mínima del modelo:

model:
  active: "deepseek-v4-pro"
  providers:
    - family: anthropic
      model: "deepseek-v4-pro"
      api_base: "https://api.deepseek.com/anthropic"
      api_key: "TU_CLAVE_API" # Puede dejarse vacío si se establece DEEPSEEK_API_KEY
      labels: ["pro", "brain"]
      disabled: false

La etiqueta brain hace que el cerebro de memoria prefiera ese proveedor. Si ningún proveedor tiene la etiqueta, las tareas de memoria utilizarán el modelo activo.

Ejecutar desde el código fuente​

Para ejecutar el proyecto directamente desde el repositorio:

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

Utilice un directorio principal (home) independiente para aislar identidades, proyectos o datos de prueba:

anda --home /ruta/a/.anda

Comando equivalente para el código fuente:

cargo run -p anda_bot -- --home /ruta/a/.anda

Actualizar​

Si instaló Anda mediante el script de instalación, actualícelo con:

anda update

Gestione el daemon en segundo plano con:

anda status
anda start
anda stop
anda restart
anda autostart status