Ir al contenido

Quickstart: de cero a consola en 5 minutos

Requisitos: Docker, Python 3.11+ con uv, Node 20+.

git clone https://github.com/hanovamx/aiuda.git && cd aiuda
cp .env.example .env                # tu ANTHROPIC_API_KEY es opcional para el demo

docker compose up -d db redis       # Postgres (puerto 5433) + Redis locales
uv sync                             # instala el workspace Python
uv run python scripts/seed.py       # datos demo: 2 agentes, cartera, conversaciones

uv run uvicorn aiuda_cloud.api.main:app --reload    # API → http://localhost:8000
cd web && npm install && npm run dev                # Consola → http://localhost:3000

Abre http://localhost:3000: verás la consola con Mariana (cobranza) y Carlos (ventas) activos, cartera con procedencia de datos y la bandeja de aprobaciones llena. La API key del tenant demo es k-demo.

Sin API key de Anthropic

El flujo completo se puede ver sin gastar:

uv run python scripts/demo.py    # import → cartera → redacción → aprobación → envío
uv run pytest                    # 41 tests con LLM mockeado, corren sin key

Con ANTHROPIC_API_KEY en .env, las acciones “Recordar” y el import inteligente de Excel usan Claude real (centavos: Haiku para triage, Sonnet para redacción).

Datos demo

uv run python scripts/seed.py --wipe    # elimina todo lo del tenant demo
uv run python scripts/seed.py --reset   # regenera desde cero

Las fechas del demo son relativas a hoy: los buckets de cartera siempre caen donde deben, sin importar cuándo lo corras.

¿Qué sigue?