Skip to main content
OpenAgno is release-ready as a Python package, but the safest installation path is still source-based until the openagno package is visible in the Python index you use. If pip install openagno is already available in your environment, you can use it. Otherwise, install from source with the steps below.

​
English

​
Requirements

  • Python 3.10 or newer. Python 3.11+ is recommended.
  • PostgreSQL with pgvector if you want vector knowledge.
  • Node.js 18+ only if you will use WhatsApp QR or run Mintlify locally.

​
Public package path

If that package is not yet available in your mirror or index, use the source path:

​
Source path

​
Contributor path

If you also want tests, builds, AG-UI, or A2A:
To prepare a local package build:

​
Explore templates

​
Complete .env

Common variables:
  • 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 if you want to protect custom routes
Foreground:
Supervisor:

​
Health check

​
Practical notes

  • If you choose database.type: sqlite, OpenAgno still runs, but without vector knowledge.
  • Slack and Telegram are part of the base installation.
  • agui and a2a require pip install -e '.[protocols]'.
  • For local WhatsApp Cloud API work, review /whatsapp-tunnel.
  • For a no-code path, read /getting-started-no-code.

​
Español

OpenAgno ya está preparado para liberarse como paquete Python, pero la ruta más segura sigue siendo instalar desde código fuente hasta que openagno aparezca en el índice PyPI o mirror que uses. Si pip install openagno ya resuelve en tu entorno, puedes usarlo; si no, sigue la ruta desde el repositorio.

​
Requisitos

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

​
Ruta pública

​
Ruta desde código fuente