Skip to main content

​
Requisitos

  • Python 3.11 o superior
  • PostgreSQL con pgvector si quieres knowledge vectorial
  • Node.js 18+ solo si usarás WhatsApp QR o Mintlify local

​
1. Instala el proyecto

git clone https://github.com/israelgo93/OpenAgno.git
cd OpenAgno
python3 -m venv .venv
source .venv/bin/activate
pip install -e .
Si también vas a desarrollar o habilitar protocolos avanzados: 
pip install -e '.[dev,protocols]'

​
2. Explora templates disponibles

openagno templates list

​
3. Crea tu workspace

La ruta más simple es copiar un template: 
openagno init --template personal_assistant

​
4. Completa .env

Variables comunes:
  • GOOGLE_API_KEY, OPENAI_API_KEY, ANTHROPIC_API_KEY
  • DB_HOST, DB_PORT, DB_USER, DB_PASSWORD, DB_NAME
  • WHATSAPP_ACCESS_TOKEN, WHATSAPP_PHONE_NUMBER_ID, WHATSAPP_VERIFY_TOKEN
  • SLACK_TOKEN, SLACK_SIGNING_SECRET
  • TELEGRAM_TOKEN
  • OPENAGNO_API_KEY si quieres proteger rutas custom

​
5. Valida antes de arrancar

openagno validate

​
6. Arranca el runtime

Foreground: 
openagno start --foreground
Supervisor local: 
openagno start
openagno status
openagno logs --follow

​
7. Verifica salud

curl http://127.0.0.1:8000/admin/health

​
Notas prácticas

  • Si eliges database.type: sqlite, OpenAgno corre, pero sin knowledge vectorial.
  • Slack y Telegram ya forman parte de la instalación base.
  • agui y a2a requieren pip install -e '.[protocols]'.
  • Si vas a usar WhatsApp Cloud API en local, solo usa WHATSAPP_SKIP_SIGNATURE_VALIDATION=true en desarrollo.