๐ Click here to follow our complete step-by-step tutorial and learn how to build this from scratch with detailed code walkthroughs, explanations, and best practices.
Sign in to save downloads to your library and vote.
Preview
๐ Breakup Recovery Agent Team
๐ FREE Step-by-Step Tutorial
๐ Click here to follow our complete step-by-step tutorial and learn how to build this from scratch with detailed code walkthroughs, explanations, and best practices.
This is an AI-powered application designed to help users emotionally recover from breakups by providing support, guidance, and emotional outlet messages from a team of specialized AI agents. The app is built using Streamlit and Agno, leveraging **Gemini 2.0 Flash (Google Vision Model) **.
๐ Features
- ๐ง Multi-Agent Team:
- Therapist Agent: Offers empathetic support and coping strategies.
- Closure Agent: Writes emotional messages users shouldn't send for catharsis.
- Routine Planner Agent: Suggests daily routines for emotional recovery.
- Brutal Honesty Agent: Provides direct, no-nonsense feedback on the breakup.
- ๐ท Chat Screenshot Analysis:
- Upload screenshots for chat analysis.
- ๐ API Key Management:
- Store and manage your Gemini API keys securely via Streamlit's sidebar.
- โก Parallel Execution:
- Agents process inputs in coordination mode for comprehensive results.
- โ
User-Friendly Interface:
- Simple, intuitive UI with easy interaction and display of agent responses.
๐ ๏ธ Tech Stack
- Frontend: Streamlit (Python)
- AI Models: Gemini 2.0 Flash (Google Vision Model)
- Image Processing: PIL (for displaying screenshots)
- Text Extraction: Google's Gemini Vision model to analyze chat screenshots
- Environment Variables: API keys managed with
st.session_statein Streamlit
๐ฆ Installation
-
Clone the Repository:
git clone https://github.com/Shubhamsaboo/awesome-llm-apps cd starter_ai_agents/ai_breakup_recovery_agent -
Install Dependencies:
pip install -r requirements.txt -
Run the Streamlit App:
streamlit run ai_breakup_recovery_agent.py
๐ Environment Variables
Make sure to provide your Gemini API key in the Streamlit sidebar:
- GEMINI_API_KEY=your_google_gemini_api_key
๐ ๏ธ Usage
- Enter Your Feelings:
- Describe how you're feeling in the text area.
- Upload Screenshot (Optional):
- Upload a chat screenshot (PNG, JPG, JPEG) for analysis.
- Execute Agents:
- Click "Get Recovery Support" to run the multi-agent team.
- View Results:
- Individual agent responses are displayed.
- A final summary is provided by the Team Leader.
๐งโ๐ป Agents Overview
-
Therapist Agent
- Provides empathetic support and coping strategies.
- Uses Gemini 2.0 Flash (Google Vision Model) and DuckDuckGo tools for insights.
-
Closure Agent
- Generates unsent emotional messages for emotional release.
- Ensures heartfelt and authentic messages.
-
Routine Planner Agent
- Creates a daily recovery routine with balanced activities.
- Includes self-reflection, social interaction, and healthy distractions.
-
Brutal Honesty Agent
- Offers direct, objective feedback on the breakup.
- Uses factual language with no sugar-coating.
Ingestion metadata
- Source catalog
- awesome-llm-apps
- Repository
- Shubhamsaboo/awesome-llm-apps ยท main
- File path
- starter_ai_agents/ai_breakup_recovery_agent/README.md
- Last refreshed
- 7/23/2026, 10:39:09 PM (4h ago)
- Refresh schedule
- Daily ยท 03:00 UTC
- Dedupe status
- Unique ยท deduped by (source, url)