Agente de Recuperação de Separação

🎓 TUTORIAL GRATUITO Passo-a-Passo

👉 Clica aqui para seguir o nosso tutorial completo passo-a-passo 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:

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

Instalação de Dependências

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

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:

npm test

6. Construir a Aplicação:

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

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.

   pip install -r requirements.txt

4. Executa a Aplicação Streamlit:

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

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.

   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.