Sobre el proyecto

AI Finance es un sistema de análisis y monitoreo del mercado que funciona de forma automática 24/7 basado en GitHub Actions. El README aclara que está destinado exclusivamente a simulación y análisis, prohíbe la negociación automática y señala que las decisiones reales de inversión requieren el criterio del usuario. Los resultados se entregan mediante un panel en GitHub Pages y alertas en tiempo real en Telegram. Las funciones principales se dividen en varias áreas. El análisis de mercado estudia cada 4 horas más de 22 valores de 7 sectores desde la perspectiva del régimen HMM, el sentimiento y la cartera. Las noticias de urgencia monitorizan cada hora 7 fuentes RSS y palabras clave de 6 categorías. El mercado extranjero rastrea cada hora 13 índices y futuros globales durante el horario de cierre de KOSPI. El monitor de crisis japonesa realiza un seguimiento diario, a las 09:30 y 22:00, de la presión de liquidación del carry trade en yenes y de la subida de tipos del BOJ. El monitor del patrón bitcoin aborda cada día a las 09:00 y 22:00 los flujos de fondos de ETF, la minería y el proyecto de ley ARMA. También incluye el área de análisis de valor. El screener de infravaloración calcula diariamente a las 06:00 la puntuación de valor y la WATCHLIST de 47 valores de KOSPI, y utiliza una evaluación relativa frente al promedio de KOSPI. El monitor de deterioro del valor vigila el deterioro de los fundamentales (EPS, BPS y rentabilidad), no de la cotización. El precio objetivo mediante DCF evalúa los flujos de efectivo de 15 grandes valores, y la revisión trimestral de resultados realiza un análisis de ganancias basado en la API de DART. AutoResearch lleva a cabo diaria y mensualmente la evolución de las ponderaciones de valor y la evaluación del Forward Test. La instalación y ejecución se describen en este orden: clonar el repositorio, instalar requirements.txt, configurar el token del bot de Telegram, el Chat ID y la clave de la API de DART, ejecutar el script de prueba local y enviar un push a GitHub para activar automáticamente los flujos de trabajo. La estructura del proyecto comprende utilidades core (cargador de variables de entorno, Telegram, wrapper de yfinance y almacenamiento de estado), docs (salida de GitHub Pages), config (definición de sectores), .github/workflows (11 flujos de trabajo), tests y diversos scripts de monitoreo y análisis. La automatización se gestiona con 11 flujos de trabajo: Daily Finance Analysis (4 horas), Breaking News Monitor (1 hora), Overseas Market Monitor (cada hora durante el cierre de KOSPI), Japan Crisis Monitor, Bitcoin Standard Monitor, Value Screener (diariamente a las 06:00), Auto-Research Value (07:00), Auto-Research Portfolio (03:00), DCF Valuator (07:30), Earnings Reviewer (09:00) y Forward Test Eval (el día 1 de cada mes a las 08:00). En materia de seguridad, se explica que las claves de API se almacenan en GitHub Secrets y se prohíbe confirmar config/.env; que defusedxml protege contra ataques XXE; que las llamadas externas usan HTTPS; que el control de concurrencia de los flujos de trabajo evita condiciones de carrera; y que las llamadas a subprocess usan argumentos en forma de lista. También se ofrecen un documento de modelo de amenazas y pruebas de regresión. La licencia y el descargo de responsabilidad recalcan que el uso es personal, con fines de aprendizaje y análisis.