# Agente de Coaching Financeiro de IA com Google ADK

> O AI Financial Coach é um consultor financeiro personalizado construído com o framework ADK (Agent Development Kit) da Google. A aplicação faz uma análise financeira completa e dá recomendações a partir dos dados indicados pelo utilizador, incluindo rendimentos, despesas, dívidas e objetivos financeiros.

- Fonte: https://doutorai.pt/apps/ai-financial-coach-agent
- Categoria: Equipas de Agentes
- Dificuldade: Avançado
- Modelos: Gemini
- Frameworks: Google ADK
- Corre local?: Precisa de APIs cloud
- Chaves necessárias: GEMINI_API_KEY, GOOGLE_API_KEY
- Licença: Apache-2.0
- Site: Doutor AI (https://doutorai.pt) - ferramentas de IA para pequenos negócios em português

## Tutorial completo

# Agente de Coach Financeiro AI com Google ADK 💰

### 🎓 Tutorial Passo-a-Passo GRÁTIS
**👉 [Clica aqui para seguir o nosso tutorial completo passo-a-passo](https://www.theunwindai.com/p/build-a-multi-agent-personal-finance-coach) 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
     ```

```markdown
# 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:

```bash
cd repository
npm install
```

## 2. **Executar o Projeto**

Para executar o projeto, utiliza o seguinte comando:

```bash
npm start
```

## 3. **Testes**

Para executar os testes, utiliza:

```bash
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:
   ```bash
   git checkout -b minha-nova-funcionalidade
   ```
3. Faz as tuas alterações e commit:
   ```bash
   git commit -m "Adiciona nova funcionalidade"
   ```
4. Faz push da tua branch:
   ```bash
   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.
```

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

```markdown
3. **Instalar Dependências**:
```

```bash
   pip install -r requirements.txt
   ```

```markdown
4. **Executa a Aplicação Streamlit**:
```

```bash
   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:

```csv
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.

## Poupe horas todas as semanas com IA, sem complicações

O **Doutor AI** dá-lhe 1859 prompts de IA prontos a copiar, por indústria e em português simples - mais uma biblioteca técnica completa para quem quer ir mais longe. [Ver planos →](https://doutorai.pt/precos)

---
Conteúdo de Doutor AI (https://doutorai.pt). Ao citar, indique a fonte: https://doutorai.pt/apps/ai-financial-coach-agent