Agente de Coaching Financeiro de IA com Google ADK

🎓 Tutorial Passo-a-Passo GRÁTIS

👉 Clica aqui para seguir o nosso tutorial completo passo-a-passo e aprende a construir isto do zero com explicações detalhadas de código e melhores práticas.

O Coach Financeiro AI é um consultor financeiro personalizado alimentado pelo framework ADK (Agent Development Kit) da Google. Esta aplicação fornece uma análise financeira abrangente e recomendações com base nas entradas do utilizador, incluindo rendimento, despesas, dívidas e objetivos financeiros.

Funcionalidades

• Sistema de Análise Financeira Multi-Agente
• Agente de Análise de Orçamento: Analisa padrões de gastos e recomenda otimizações
• Agente de Estratégia de Poupança: Cria planos de poupança personalizados e estratégias para fundo de emergência
• Agente de Redução de Dívidas: Desenvolve estratégias otimizadas para pagamento de dívidas utilizando métodos de avalanche e bola de neve

• Análise de Despesas:
• Suporta tanto o upload de CSV como a entrada manual de despesas
• Análise de transações CSV com rastreamento de data, categoria e montante
• Quebra visual dos gastos por categoria
• Categorização automática de despesas e deteção de padrões

• Recomendações de Poupança:
• Dimensionamento de fundo de emergência e estratégias de construção
• Alocações de poupança personalizadas para diferentes objetivos
• Técnicas práticas de automação para poupança consistente
• Rastreio de progresso e recomendações de marcos

• Gestão de Dívidas:
• Gestão de múltiplas dívidas com otimização da taxa de juro
• Comparação entre métodos de avalanche e bola de neve
• Cronograma visual de pagamento de dívidas e análise de poupanças em juros
• Recomendações acionáveis para redução de dívidas

• Visualizações Interativas:
• Gráficos de pizza para quebra de despesas
• Gráficos de barras para rendimento vs. despesas
• Gráficos de comparação de dívidas
• Métricas de rastreio de progresso

Como Executar

Segue os passos abaixo para configurar e executar a aplicação:

1. Obter Chave API:

• Obtém uma chave API Gemini gratuita do Google AI Studio: https://aistudio.google.com/apikey
• Cria um ficheiro .env na raiz do projeto e adiciona a tua chave API:

     GOOGLE_API_KEY=your_api_key_here
     ```


**Clone o Repositório**

Para clonares o repositório, utiliza o seguinte comando:

```bash
git clone https://github.com/username/repository.git

Substitui https://github.com/username/repository.git pela URL do repositório que desejas clonar.

1. Instalação de Dependências****

Depois de clonares o repositório, navega até à pasta do projeto e instala as dependências necessárias:

cd repository
npm install

2. Executar o Projeto****

Para executar o projeto, utiliza o seguinte comando:

npm start

3. Testes****

Para executar os testes, utiliza:

npm test

4. Contribuição****

Se desejas contribuir para este projeto, por favor, segue os passos abaixo:

1. Faz um fork do repositório.
2. Cria uma nova branch para a tua funcionalidade ou correção:

git checkout -b minha-nova-funcionalidade

3. Faz as tuas alterações e commit:

git commit -m "Adiciona nova funcionalidade"

4. Faz push da tua branch:

git push origin minha-nova-funcionalidade

5. Cria um Pull Request.

5. Licença****

Este projeto está licenciado sob a MIT License - vê o ficheiro [LICENSE](LICENSE) para mais detalhes.

   git clone https://github.com/Shubhamsaboo/awesome-llm-apps.git
   cd awesome-llm-apps/advanced_ai_agents/multi_agent_apps/ai_financial_coach_agent/

3. Instalar Dependências:

   pip install -r requirements.txt

4. Executa a Aplicação Streamlit:

   streamlit run ai_financial_coach_agent.py

Formato de Ficheiro CSV

A aplicação aceita ficheiros CSV com as seguintes colunas obrigatórias:

• Date: Data da transação no formato AAAA-MM-DD
• Category: Categoria da despesa
• Amount: Montante da transação (suporta símbolos de moeda e formatação com vírgulas)

Exemplo:

Date,Category,Amount
2024-01-01,Housing,1200.00
2024-01-02,Food,150.50
2024-01-03,Transportation,45.00

Como utilizar o template CSV

Um ficheiro template CSV pode ser descarregado diretamente da barra lateral da aplicação.