README.md

metadata

sdk: gradio

Painel de Análise de Portfólio Visão Geral Este projeto é um painel interativo baseado em Gradio para análise de portfólios financeiros, replicando as visualizações de um notebook Colab sobre teoria de portfólios. Ele utiliza a biblioteca yfinance para obter dados históricos de ações, realiza simulações Monte Carlo, calcula retornos, correlações, Valor em Risco (VaR) e apresenta visualizações como a fronteira eficiente e a evolução do portfólio. O painel permite personalizar tickers, intervalos de datas, número de simulações e investimento inicial. Funcionalidades

Preços Históricos: Gráfico interativo Plotly com o histórico de preços das ações. Histórico de Retornos: Retornos logarítmicos ao longo do tempo para os ativos selecionados. Matriz de Correlação: Mapa de calor das correlações entre retornos dos ativos. Fronteira Eficiente: Gráfico de dispersão de simulações Monte Carlo com o portfólio ótimo destacado. Evolução do Portfólio: Acompanha o valor do portfólio ao longo do tempo com base em pesos otimizados. Retornos Diários: Visualiza os retornos diários do portfólio com linha de média. Análise de VaR: VaR histórico e Monte Carlo com histogramas e tabela de resumo. Estatísticas: Estatísticas descritivas dos retornos e métricas de VaR.

Requisitos O aplicativo requer os seguintes pacotes Python, listados no arquivo requirements.txt: gradio pandas yfinance numpy matplotlib plotly scipy seaborn

Instruções de Configuração

Clonar o Repositório (se hospedado no Git): git clone <url-do-repositório> cd painel-analise-portfolio

Instalar Dependências: pip install -r requirements.txt

Executar Localmente: python app.py

Isso inicia a interface Gradio localmente, acessível via navegador (ex.: http://localhost:7860).

Como Usar

Acessar o Painel:

Abra a interface Gradio (local ou hospedada). Insira os parâmetros: Tickers: Símbolos das ações separados por vírgula (ex.: BBAS3.SA,ITSA4.SA,TAEE11.SA,TTEN3.SA,BPAC11.SA,^BVSP). Data Inicial: Formato AAAA-MM-DD (ex.: 2012-01-01). Data Final: Formato AAAA-MM-DD (ex.: 2024-07-31). Número de Simulações: Para Monte Carlo (padrão: 50.000). Investimento Inicial: Em reais (padrão: 35.000).

Clique em Executar Análise para gerar as visualizações.

Explorar Visualizações:

Navegue pelas abas: Preços Históricos, Histórico de Retornos, Matriz de Correlação, Fronteira Eficiente, Evolução do Portfólio, Retornos Diários, Análise de VaR e Estatísticas. Passe o mouse sobre os gráficos Plotly para detalhes interativos (zoom, pan, etc.).

Implantação no Hugging Face Spaces Para implantar o painel no Hugging Face Spaces:

Criar um Space:

Acesse huggingface.co/new-space. Selecione Gradio como SDK. Nomeie o Space (ex.: painel-analise-portfolio). Defina a visibilidade (Público ou Privado).

Fazer Upload dos Arquivos:

Envie app.py e requirements.txt. Confirme as alterações para iniciar o build.

Acessar o Painel:

Após o build, acesse a URL pública fornecida pelo Hugging Face. Opcionalmente, ative GPU nas configurações do Space para simulações Monte Carlo mais rápidas.

Solução de Problemas

Nenhum Dado Carregado: Verifique se os tickers são válidos no Yahoo Finance (ex.: BBAS3.SA para ações brasileiras, ^BVSP para IBOVESPA). Confirme que o intervalo de datas está dentro dos dados disponíveis (até 21/09/2025, data atual).

Gráficos Não Exibidos: Consulte os logs do Hugging Face Space para erros (ex.: dependências ausentes). Reduza o num_simulations (ex.: para 10.000) se houver problemas de memória.

Problemas com API: O Yahoo Finance pode falhar para alguns tickers. Teste com menos tickers ou tente novamente após um intervalo.

Contribuições Contribuições são bem-vindas! Para contribuir:

Faça um fork do repositório. Crie uma branch para sua funcionalidade (git checkout -b nome-funcionalidade). Faça commit das alterações (git commit -m "Adiciona funcionalidade"). Envie para a branch (git push origin nome-funcionalidade). Abra um Pull Request.

Licença Este projeto está licenciado sob a Licença MIT. Agradecimentos

Desenvolvido com Gradio para a interface interativa. Utiliza yfinance para dados de ações. Inspirado em conceitos de teoria de portfólios e simulações Monte Carlo.