# Agente de Recuperação de Separação

> Esta é uma aplicação baseada em IA, projetada para ajudar os utilizadores a recuperar emocionalmente de separações, fornecendo apoio, orientação e mensagens de desabafo de uma equipa de agentes de IA especializados.

- Fonte: https://doutorai.pt/apps/ai-breakup-recovery-agent
- Categoria: Agentes para Começar
- Dificuldade: Fácil
- Modelos: Gemini
- Frameworks: Agno
- Corre local?: Precisa de APIs cloud
- Chaves necessárias: GEMINI_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

# 💔 Equipa de Recuperação de Relacionamentos

### 🎓 TUTORIAL GRATUITO Passo-a-Passo 
**👉 [Clica aqui para seguir o nosso tutorial completo passo-a-passo](https://www.theunwindai.com/p/build-an-ai-breakup-recovery-agent-team-f29b) e aprende como construir isto do zero com explicações detalhadas e melhores práticas.**

Esta é uma aplicação baseada em IA, projetada para ajudar os utilizadores a recuperar emocionalmente de separações, fornecendo apoio, orientação e mensagens de desabafo de uma equipa de agentes de IA especializados. A aplicação é construída utilizando **Streamlit** e **Agno**, aproveitando **Gemini 2.0 Flash (Google Vision Model)**.

## 🚀 Funcionalidades

- 🧠 **Equipa Multi-Agente:** 
    - **Agente Terapeuta:** Oferece apoio empático e estratégias de coping.
    - **Agente de Fecho:** Escreve mensagens emocionais que os utilizadores não devem enviar para catarsis.
    - **Agente Planeador de Rotinas:** Sugere rotinas diárias para recuperação emocional.
    - **Agente de Honestidade Brutal:** Fornece feedback direto e sem rodeios sobre a separação.
- 📷 **Análise de Capturas de Ecrã de Conversas:**
    - Carrega capturas de ecrã para análise de conversas.
- 🔑 **Gestão de Chaves de API:**
    - Armazena e gere as tuas chaves de API Gemini de forma segura através da barra lateral do Streamlit.
- ⚡ **Execução Paralela:** 
    - Os agentes processam entradas em modo de coordenação para resultados abrangentes.
- ✅ **Interface Amigável:** 
    - UI simples e intuitiva com interação fácil e exibição das respostas dos agentes.

---

## 🛠️ Stack Tecnológico

- **Frontend:** Streamlit (Python)
- **Modelos de IA:** Gemini 2.0 Flash (Google Vision Model)
- **Processamento de Imagem:** PIL (para exibir capturas de ecrã)
- **Extração de Texto:** Modelo Gemini Vision do Google para analisar capturas de ecrã de conversas
- **Variáveis de Ambiente:** Chaves de API geridas com `st.session_state` no Streamlit

---

## 📦 Instalação

1. **Clona o Repositório:**

```bash
   git clone https://github.com/Shubhamsaboo/awesome-llm-apps
   cd starter_ai_agents/ai_breakup_recovery_agent
   ```

```markdown
# Instalação de Dependências

Para começar, precisas de instalar as dependências necessárias. Executa o seguinte comando:

```bash
npm install
```

3. **Configuração do Ambiente:**

Antes de executar a aplicação, deves configurar as variáveis de ambiente. Cria um ficheiro `.env` na raiz do projeto e adiciona as seguintes variáveis:

```
DATABASE_URL=your_database_url
API_KEY=your_api_key
```

4. **Executar a Aplicação:**

Para iniciar a aplicação, utiliza o comando:

```bash
npm start
```

5. **Testes:**

Para executar os testes, utiliza o seguinte comando:

```bash
npm test
```

6. **Construir a Aplicação:**

Se precisares de construir a aplicação para produção, executa:

```bash
npm run build
```

7. **Contribuição:**

Se desejas contribuir para este projeto, segue os seguintes passos:

1. Faz um fork do repositório.
2. Cria uma nova branch para a tua funcionalidade ou correção de bug.
3. Faz as tuas alterações e commit.
4. Envia um pull request.

8. **Licença:**

Este projeto está licenciado sob a Licença MIT. Consulta o ficheiro `LICENSE` para mais informações.
```

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

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

   Para executar a aplicação Streamlit, utiliza o seguinte comando no terminal:

   ```bash
   streamlit run app.py
   ```

   Após executar o comando, a aplicação abrir-se-á automaticamente no teu navegador padrão. Se não abrir, podes aceder manualmente ao endereço `http://localhost:8501`.
```

```bash
   streamlit run ai_breakup_recovery_agent.py
   ```

## 🔑 Variáveis de Ambiente

Certifica-te de fornecer a tua **chave de API Gemini** na barra lateral do Streamlit:

- GEMINI_API_KEY=your_google_gemini_api_key

---

## 🛠️ Utilização

1. **Insere os Teus Sentimentos:** 
    - Descreve como te sentes na área de texto.
2. **Carrega Captura de Ecrã (Opcional):**
    - Carrega uma captura de ecrã da conversa (PNG, JPG, JPEG) para análise.
3. **Executa Agentes:**
    - Clica em **"Obter Apoio à Recuperação"** para executar a equipa de múltiplos agentes.
4. **Vê Resultados:**
    - As respostas dos agentes individuais são exibidas.
    - Um resumo final é fornecido pelo Líder da Equipa.

---

## 🧑‍💻 Visão Geral dos Agentes

- **Agente Terapeuta**
    - Fornece apoio empático e estratégias de coping.
    - Utiliza **Gemini 2.0 Flash (Modelo de Visão do Google)** e ferramentas DuckDuckGo para obter insights.
  
- **Agente de Fecho**
    - Gera mensagens emocionais não enviadas para libertação emocional.
    - Garante mensagens sinceras e autênticas.

- **Agente Planeador de Rotina**
    - Cria uma rotina diária de recuperação com atividades equilibradas.
    - Inclui autorreflexão, interação social e distrações saudáveis.

- **Agente de Honestidade Brutal**
    - Oferece feedback direto e objetivo sobre o fim da relação.
    - Utiliza uma linguagem factual sem rodeios.

## 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-breakup-recovery-agent