FundFinder

Localizador de fundos

FundFinder é um aplicativo Streamlit poderoso e intuitivo projetado para ajudar os investidores a selecionar os melhores fundos mútuos, fornecendo comparações e insights detalhados. O aplicativo coleta dados de fundos mútuos da Internet, calcula retornos antes e depois dos impostos e compara fundos com base em seus índices de desempenho e despesas. Ele também visualiza os dados para ajudar na tomada de decisões de investimento informadas.

Características

• Extração de dados de fundos : busque automaticamente detalhes de fundos mútuos na Internet.
• Cálculos de retorno : calcule os retornos reais antes e depois dos impostos.
• Comparação de índices de despesas : compare diferentes fundos com base em seus índices de despesas.
• Visualização interativa : crie gráficos para visualizar o desempenho e as comparações dos fundos.
• Insights gerados por IA : Receba uma análise de prós e contras do fundo selecionado na página de retorno do lote.
• Interface amigável : construída com Streamlit para uma experiência de usuário perfeita.

Instalação

Para configurar o FundFinder, você precisa ter Python e Streamlit instalados. Siga estas etapas para começar:

1. Clone o repositório :

   git clone https://github.com/yourusername/FundFinder.git
   cd FundFinder

2. Crie e ative um ambiente virtual (opcional, mas recomendado):

   python -m venv venv
   source venv/bin/activate  # On Windows use `venvScriptsactivate`

3. Instale os pacotes necessários :

   pip install -r requirements.txt

4. Configurar recursos de IA :

   Você pode personalizar os insights gerados pela IA adicionando seu GROQ_API_KEY e especificando o nome do modelo no arquivo .env . O modelo de IA utilizado atualmente é GROQ_LLama . Para configurar, atualize o arquivo .env assim:

   GROQ_API_KEY=your_api_key
   GROQ_LLama=model_name

Uso

1. Execute o aplicativo Streamlit :

   streamlit run app.py

2. Interaja com o aplicativo :

   • Seleção de fundos : navegue pela lista de fundos mútuos.
   • Ver detalhes do fundo : veja informações detalhadas sobre cada fundo.
   • Compare fundos : analise e compare diferentes fundos com base em retornos e índices de despesas.
   • Visualize dados : visualize gráficos que ilustram o desempenho do fundo.
   • AI Insights : Na página de retorno do gráfico, obtenha análises de prós e contras geradas por IA do fundo selecionado.

Estrutura do Projeto

 |---_temp 
|   |-- config.py
|
|---components 
|   |-- footer.py
|
|--- data 
|   |-- mutual_fund_data.csv
|
|--- dump 
|   |-- temp_data.csv
|
|--- notebooks 
|   |-- test.ipynb
|
|--- pages 
|   |-- admin_page.ipynb
|   |-- fund_list.ipynb
|   |-- plot_return.ipynb
|   |-- return_calculator.ipynb
|
|--- schema 
|   |-- LLM_output.py
|
|--- scrap 
|   |-- scrape.py
|
|--- utils 
|   |-- calculate_return.py
|   |-- auth.py
|   |-- generate_response.py
|
|--- app.py 
|--- .env 
|--- config.yml 
|--- .gitignore 
|--- LICENSE
|--- README.md 
|--- requirements.txt

Requisitos

• Python 3.7 ou superior
• Streamlit
• pandas
• entorpecido
• solicitações (para web scraping)
• BeautifulSoup (para analisar HTML)
• API Groq (para insights gerados por IA)

Licença

Este projeto está licenciado sob a licença MIT. Consulte o arquivo LICENSE para obter detalhes.

Contribuindo

Contribuições são bem-vindas! Bifurque o repositório e envie uma solicitação pull com suas alterações. Para mudanças importantes, abra primeiro uma edição para discutir o que você gostaria de mudar.

Contato

Para qualquer dúvida ou feedback, entre em contato com [email protected].

---

Feliz investimento!