Update README.md

README.md

@@ -1,39 +1,122 @@
----
-title: Análise de Portfólio - Ações Brasileiras
-emoji: 📊
-colorFrom: blue
-colorTo: purple
-sdk: gradio
-sdk_version: 4.24.0
-app_file: app.py
-pinned: false
----
+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
 
-# 📊 Análise de Portfólio de Ações Brasileiras
+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.
 
-## 📋 Descrição
+Requisitos
+O aplicativo requer os seguintes pacotes Python, listados no arquivo requirements.txt:
+gradio
+pandas
+yfinance
+numpy
+matplotlib
+plotly
+scipy
+seaborn
 
-Aplicação interativa para análise de carteiras de ações brasileiras usando a Teoria Moderna do Portfólio de Markowitz.
+Instruções de Configuração
 
-## 🎯 Funcionalidades
+Clonar o Repositório (se hospedado no Git):
+git clone <url-do-repositório>
+cd painel-analise-portfolio
 
-- 📈 Histórico de preços de múltiplas ações
-- 🔗 Matriz de correlação entre ativos  
-- 📊 Retornos acumulados
-- ⚖️ Otimização de portfólio
-- 📋 Estatísticas descritivas
 
-## 🚀 Como Usar
+Instalar Dependências:
+pip install -r requirements.txt
 
-1. Selecione as ações desejadas
-2. Defina o período de análise
-3. Clique em "Analisar"
-4. Explore os gráficos e resultados
 
-## 📊 Ações Disponíveis
+Executar Localmente:
+python app.py
 
-20 ações do IBOVESPA + índice IBOVESPA como benchmark.
+Isso inicia a interface Gradio localmente, acessível via navegador (ex.: http://localhost:7860).
 
-## ⚠️ Nota
 
-Esta aplicação é para fins educacionais e não constitui recomendação de investimento.
+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.