Desarrollo local

Para usuarios avanzados que quieran personalizar el código, probar modificaciones o disparar corridas manualmente. La mayoría de los usuarios no necesitan esto — GitHub Actions maneja todo automáticamente.

Requisitos

Node.js 22+ — Descargar
npm — viene con Node.js

Instalación

git clone https://github.com/YOUR_USERNAME/richfolio.git
cd richfolio
npm install

Configuración

Portafolio (`config.json`)

cp config.example.json config.json

Edita config.json con tus asignaciones objetivo y tenencias actuales. Consulta Configuración para la referencia completa de campos.

Claves de API (`.env`)

cp .env.example .env

Agrega tus claves de API. Como mínimo necesitas RESEND_API_KEY y RECIPIENT_EMAIL. Consulta Claves de API para instrucciones paso a paso de cada servicio.

Ejecución

# Resumen diario — precios + noticias + análisis IA + correo + Telegram
npm run dev

# Verificación de alerta intradía — compara vs baseline matutina
npm run intraday

# Reporte semanal de rebalanceo — precios + drift de asignación + correo + Telegram
npm run weekly

# Re-analizar un único ticker con precio after-hours
npm run refresh -- SMH

# Type-check sin emitir
npx tsc --noEmit

Revisa tu correo y Telegram para los resultados.