Skip to main content
Esta guía está pensada para personas que quieren usar OpenAgno localmente sin desarrollar el framework. Vas a descargar el repositorio, crear 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

Puedes hacerlo con GitHub Desktop, con un ZIP del repositorio o con git clone. Si usas terminal: 
git clone https://github.com/israelgo93/OpenAgno.git
cd OpenAgno

​
Paso 2. Ejecuta el bootstrap

bash setup.sh
Ese script:
  • crea .venv
  • instala OpenAgno en modo editable
  • 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

openagno start --foreground

​
Paso 5. Verifica salud

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

​
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.