ai-finance

AI Finance é um sistema de análise e monitoramento de mercado operado automaticamente 24/7 com base no GitHub Actions. O README deixa claro que o sistema é exclusivamente para simulação e análise, proíbe negociação automática e informa que as decisões reais de investimento exigem o julgamento do usuário. Os resultados são entregues por um dashboard no GitHub Pages e por alertas em tempo real no Telegram. As funcionalidades principais estão divididas em várias áreas. A análise de mercado avalia, a cada 4 horas, mais de 22 ações de 7 setores sob as perspectivas de regime HMM, sentimento e portfólio. O módulo de notícias urgentes monitora, a cada hora, 7 feeds RSS e palavras-chave de 6 categorias. O mercado externo rastreia, a cada hora durante o fechamento do KOSPI, 13 índices e futuros globais. O Japan Crisis Monitor acompanha diariamente, às 09:30 e às 22:00, a pressão de encerramento de carry trade em iene e os aumentos de juros do BOJ. O Bitcoin Standard Monitor aborda diariamente, às 09:00 e às 22:00, fluxos de capital de ETFs, mineração e o projeto de lei ARMA. Também há uma linha de análise de valor. O Value Screener calcula diariamente, às 06:00, a pontuação de valor e a WATCHLIST de 47 ações do KOSPI, usando avaliação relativa em comparação com a média do KOSPI. O monitor de deterioração de valor acompanha a deterioração de fundamentos — EPS, BPS e lucratividade —, não do preço da ação. O DCF Valuator avalia os fluxos de caixa de 15 ações de grande capitalização, e a revisão trimestral de resultados realiza análises de earnings baseadas na DART API. O AutoResearch executa diariamente e mensalmente a evolução dos pesos de valor e a avaliação do Forward Test. A instalação e a execução são apresentadas na seguinte ordem: clonar o repositório, instalar o requirements.txt, configurar o token do Telegram Bot, o Chat ID e a chave da DART API, executar o script de teste local e fazer push no GitHub para acionar automaticamente os workflows. A estrutura do projeto é formada por utilitários em core — carregador de variáveis de ambiente, Telegram, wrapper do yfinance e persistência de estado —, docs, que contém a saída do GitHub Pages, config, com as definições de setores, .github/workflows, com 11 workflows, tests e vários scripts de monitoramento e análise. A automação é operada por 11 workflows: Daily Finance Analysis, a cada 4 horas; Breaking News Monitor, a cada hora; Overseas Market Monitor, a cada hora durante o fechamento do KOSPI; Japan Crisis Monitor; Bitcoin Standard Monitor; Value Screener, diariamente às 06:00; Auto-Research Value, às 07:00; Auto-Research Portfolio, às 03:00; DCF Valuator, às 07:30; Earnings Reviewer, às 09:00; e Forward Test Eval, no primeiro dia de cada mês às 08:00. No aspecto de segurança, o sistema armazena chaves de API no GitHub Secrets, proíbe o commit de config/.env, usa defusedxml para defender contra ataques XXE, faz chamadas externas via HTTPS, emprega controle de concorrência nos workflows para evitar race conditions e utiliza list args em chamadas subprocess. Também são fornecidos um documento de modelo de ameaças e testes de regressão. A licença e o termo de isenção de responsabilidade enfatizam que o projeto se destina a aprendizado pessoal e análise.