quantvibe

O QuantVibe é um projeto de integração que conecta o Microsoft Qlib e o HKUDS Vibe-Trading sem fazer fork de nenhuma das ferramentas. O Qlib treina modelos de machine learning sobre dados de mercado e produz pontuações de ranking de ações, enquanto o Vibe-Trading consome essas pontuações através de um servidor FastMCP somente leitura e age sobre elas, com paper trading como modo de execução padrão. A ponte é implementada em cerca de 600 linhas de Python sem dependências pesadas. Os dois sistemas nunca se importam mutuamente; comunicam-se através de um contrato assinado imutável (artifacts/signals.json com checksums SHA-256) e um servidor FastMCP stdio. Cada lado é executado no seu próprio ambiente virtual para evitar conflitos de dependências. As principais funcionalidades incluem um modo de demonstração de um único comando usando dados de tendência sintéticos e um fallback de momentum, um modo real que descarrega dados OHLCV via yfinance, converte-os para o formato binário do Qlib, calcula características Alpha158 e treina um ranker LightGBM. Antes de os sinais serem publicados, um portão de avaliação verifica a correlação de Spearman (IC), o ICIR e a taxa de acerto top-k em relação aos retornos futuros. Um registo de histórico SQLite liquida sinais históricos contra preços realizados e reporta a taxa de acerto e o retorno excedente. O servidor FastMCP expõe três ferramentas somente leitura: get_latest_signals, list_universe e signal_health. A execução tem dupla proteção: a submissão real de ordens ao broker requer tanto o flag --submit como a variável de ambiente VIBE_ALLOW_ORDERS=1. Conectores adicionais incluem uma ponte EA nativa MetaTrader 5 para Forex, CFDs e prop firms, além de um fluxo de notícias financeiras RSS ao estilo Bloomberg com monitorização multi-universo. O projeto inclui um terminal web fintech moderno construído com FastAPI, React 19, TypeScript e Tailwind CSS. Fornece um dashboard com portões de qualidade do modelo, um lançador de pipeline interativo com streaming SSE, uma mesa de execução com interruptor de segurança paper/live, vistas de auditoria do histórico e um inspetor MCP. O código-fonte do frontend reside em web/frontend/ e compila para recursos estáticos em web/static/. As opções de implantação incluem ambientes virtuais isolados via scripts/setup.ps1, Docker com uma imagem pré-construída no GitHub Container Registry, e um serviço em segundo plano 24/7 usando nohup. O projeto é distribuído sob a Licença MIT e inclui um aviso legal que enfatiza o uso apenas educacional e de investigação.