TalkHeal Mental Health Companion | THIS IS FLORIDA
A Python app that combines an AI chat companion with mood tracking, journaling, breathing exercises and crisis resources. Chats are sent to Google's Gemini AI service. Not a substitute for professional care. In crisis call or text 988.
Florida information in plain text. No need to ask AI.
Quick facts
- Title: TalkHeal
- Author: Sagnik Chakraborty (copyright holder in the LICENSE file)
- Year: This copy created 2025
- Subject: Mental health self-help tools with AI chat
- Format: Python Streamlit app; needs a Google Gemini API key; chat goes to Google's Gemini service
- Who it suits: Adults who want self-help tools alongside professional care; Python learners studying the code
- Note: This repository is a fork (copy) of the eccentriccoder01/TalkHeal project, which the README's install steps point to
- License: MIT License (LICENSE file in the repository, checked today)
What it covers
The README describes a chatbot built on Google's Gemini models, with five tones to choose from, such as Compassionate Listener and Mindfulness Guide, and saved chat sessions. It adds a mood dashboard with a five-level scale and charts, a journal saved to a local SQLite database with sentiment labels, coping tips and micro-journaling prompts.
Self-help tools listed include yoga pose suggestions, focus sessions with a timer and breathing animation, a guided breathing exercise, quick coping cards, and wellness tips for mind, body, nutrition, sleep and stress relief.
It also lists an Emergency Help page of crisis hotlines, self-check quizzes (GAD-7, PHQ-9 and WHO-5), and a symptom-based tool that uses machine learning models to suggest possible conditions and a type of medical specialist.
How to use it
Use the breathing exercise and coping cards for short stress breaks, and the mood dashboard to notice patterns you can bring to a counselor or doctor.
Treat quiz scores and specialist suggestions as prompts for a conversation with a licensed professional, never as a diagnosis.
How it runs: the README says to get the code, install the Python packages, add a Google Gemini API key to the Streamlit secrets, and start it with Streamlit. Messages you type in chat are sent to Google's Gemini service to generate replies, so do not share details you want kept private. The README also lists a hosted demo, but it did not load when we checked today.
License and how to get it
The repository LICENSE file is the MIT License. THIS IS FLORIDA describes the project and links to the official repository; we do not host its code.
Safety note
Not a substitute for professional care. In crisis call or text 988.
The README itself says TalkHeal is not a substitute for professional care. AI replies can be wrong or unsuitable in a crisis. Florida residents can also find crisis and involuntary examination information in our Baker Act guide.
Official source
Reviewed November 21, 2026. The official page below controls if the license, contents or instructions change.
THIS IS FLORIDA is an independent informational resource and is not affiliated with the authors, publishers or projects named on this page. Confirm current details at the official source before acting.