TalkHeal is an empathetic, intelligent, and interactive mental health support assistant built using Python and Streamlit. Designed with compassion and care at its core, it offers 24/7 support, emotional journaling, resource guidance, and AI-powered conversations powered by Google’s Gemini Pro.
- Gemini-powered chatbot for mental health companionship
- Empathetic and encouraging tone—never clinical or diagnostic
- Smart conversation history with multi-threaded support
- Chatbot personality tone selector
- Mental health resource library with live search
- International emergency contacts and helpline shortcuts
- Quick access to location-based therapy centers via Google Maps
- Mood slider with five emotional states
- AI-assisted coping tips based on mood
- Micro-journaling support with reflection prompts
- Instant-start suggestions like “Feeling overwhelmed” or “How to manage stress?”
- Direct conversion of journal thoughts into chatbot prompts
- Sidebar toggling for focus-driven interaction
- 3D-inspired soft pink and magenta UI, best suited for a mentally soothing and peaceful outlook
- Smooth transitions and responsive design for mobile and desktop
Experience TalkHeal live here:
👉
For a detailed walkthrough of TalkHeal's features and how to use them, check out this video:
[Insert YouTube Video Link Here]
| Tech | Purpose |
|---|---|
| Python | Core backend and AI logic |
| Streamlit | UI and frontend integration |
| Google Gemini API | Generative AI Conversations |
| Session State | Manage multi-threaded chat memory |
| CSS Variables | Theming and modern styling |
| Streamlit Secrets | Secure API key management |
Clone and run locally using Python and Streamlit.
-
Clone the repository:
git clone https://github.com/eccentriccoder01/TalkHeal.git cd TalkHeal -
Install dependencies:
pip install -r requirements.txt
-
Set up API key: Go to your Streamlit Secrets Settings and add:
[gemini] api_key = "YOUR_GOOGLE_GEMINI_API_KEY"
-
Run the app:
streamlit run TalkHeal.py
Report bugs and issues or propose improvements through our GitHub repository.
-
Firstly Star(⭐) the Repository
-
Fork the Repository and create a new branch for any updates/changes/issue you are working on.
-
Start Coding and do changes.
-
Commit your changes
-
Create a Pull Request which will be reviewed and suggestions would be added to improve it.
-
Add Screenshots and updated website links to help us understand what changes is all about.
-
Check the CONTRIBUTING.md for detailed steps...
We welcome all contributions and suggestions! Whether it's a new feature, design improvement, or a bug fix — your voice matters 💜
Your insights are invaluable to us. Reach out to us team for any inquiries, feedback, or concerns.
This project is open-source and available under the MIT License.
Developed by Eccentric Explorer
Feel free to reach out with any questions or feedback!