Instalación y Arranque Local

Requisitos del Sistema

Se requiere Node.js 22+ (o Node 24) y el gestor de paquetes pnpm 10. En Windows PowerShell, recuerda ejecutar comandos individuales sin el operador &&.

1. Clonar el Repositorio

git clone https://github.com/Ghekkin/Reto-Banorte-hack-mty.git
cd Reto-Banorte-hack-mty

---

2. Variables de Entorno

Copia el archivo de ejemplo .env.example a .env:

cp .env.example .env

Configura las dos variables principales en .env:

• DATABASE_URL: Cadena de conexión a PostgreSQL (ej. postgresql://postgres:contraseña@localhost:5432/reto_banorte).
• GEMINI_API_KEY: Llave de Google AI Studio para el modelo principal (gemini-3.8-flash o gemini-2.5-flash).
• (Opcional) ANTHROPIC_API_KEY: Llave de Claude para el respaldo.

---

3. Instalación de Dependencias

Ejecuta en la raíz del monorepo:

pnpm install

---

4. Inicialización de la Base de Datos

Si tu base de datos está vacía, pobla las 22 tablas y los datos sintéticos de los perfiles demo:

# Aplica las migraciones de esquema
pnpm datos:migrar

# Restaura los registros de Beto, Ana y Carmen desde el fixture oficial
pnpm datos:restaurar

---

5. Levantar los Servicios

Para levantar la suite completa en simultáneo:

pnpm dev

Esto inicia:

• Servidor MCP: en http://localhost:3100 (con healthcheck en /health).
• Frontend Web & Agente Host: en http://localhost:3000.
• Documentación Astro: en http://localhost:4321 (ejecutando pnpm dev:docs).

Abre http://localhost:3000 en tu navegador para interactuar con Maya.