Skip to main content
This guide is for people who want to run OpenAgno locally without developing the framework itself. You will download the repository, bootstrap the environment, and start from a ready-to-fill workspace.

​
English

​
What you need

  • Python 3.10 or newer
  • A basic terminal
  • Optional: PostgreSQL if you want vector knowledge

​
Step 1. Download the project

You can use GitHub Desktop, a ZIP download, or git clone.

​
Step 2. Run the bootstrap

That script:
  • creates .venv
  • installs OpenAgno with development and protocol extras
  • initializes workspace/ from personal_assistant
  • validates the workspace

​
Step 3. Complete .env

Set at least:
  • one model API key (GOOGLE_API_KEY, OPENAI_API_KEY, or ANTHROPIC_API_KEY)
  • database variables if you will use PostgreSQL or Supabase
  • the channel variables for the channel you want to enable

​
Step 4. Start the runtime

​
Step 5. Check health

​
Español

Esta guía está pensada para personas que quieren usar OpenAgno localmente sin desarrollar el framework. Vas a descargar el repositorio, preparar el entorno y levantar un workspace listo para completar.

​
Qué necesitas

  • Python 3.10 o superior
  • Una terminal básica
  • Opcional: PostgreSQL si vas a usar knowledge vectorial

​
Paso 1. Descarga el proyecto

​
Paso 2. Ejecuta el bootstrap

Ese script:
  • crea .venv
  • instala OpenAgno con extras de desarrollo y protocolos
  • crea workspace/ desde personal_assistant
  • valida que la base del workspace esté correcta

​
Paso 3. Completa .env

Abre el archivo .env y define al menos:
  • una API key de modelo (GOOGLE_API_KEY, OPENAI_API_KEY o ANTHROPIC_API_KEY)
  • las variables de base de datos si usarás PostgreSQL/Supabase
  • las variables del canal que quieras activar

​
Paso 4. Arranca el runtime

​
Paso 5. Verifica salud

​
Qué hacer después

  • Si vas a usar Slack, ejecuta openagno add slack.
  • Si vas a usar Telegram, ejecuta openagno add telegram.
  • Si vas a usar WhatsApp Cloud API en local, sigue /whatsapp-tunnel.
  • Si prefieres el flujo técnico completo, vuelve a /quickstart.