---
title: Serenity chatbot 4.5
sdk: gradio
emoji: ⚡
colorFrom: indigo
colorTo: purple
pinned: false
---
🌸 Serenity — Your Emotional Support Chatbot

> A safe, soothing space where you can talk freely. Serenity listens, understands, and supports you — emotionally, mentally, and spiritually — whenever you need someone by your side.




---

💬 What Serenity Can Do

🪷 Emotional Support:
Serenity listens to your feelings and responds with empathy, validation, and warmth — not robotic sympathy.

🧠 Intelligent Conversation:
Serenity adapts to your tone — calm when you’re sad, cheerful when you’re happy, deep when you’re reflective.

💛 Follow-up Memory:
If you felt low recently, Serenity remembers (for 10–15 days) and checks on you gently next time.

🎙️ Multiple Voices:
Choose from 8 calming voices (male/female/neutral) — from deep and soothing to soft and nurturing.

🌀 Avatar Animation:
A gentle, breathing avatar reacts as you talk — creating a peaceful, human-like experience.

🌈 Dynamic Colors:
The interface changes between soft, calming hues for variety and comfort.


---

🛠️ Tech Stack

Component	Technology

Frontend	HTML, CSS, JS (voice + emotion + avatar UI)
Backend	Flask + OpenAI API
AI Model	GPT-4-turbo / GPT-4o
Emotion Analysis	DistilRoBERTa (via Transformers)
Voice	gTTS (text-to-speech)
Hosting	Hugging Face Spaces



---

⚙️ Environment Variables

In your Hugging Face Space → Settings → Repository Secrets, add:

Variable	Example	Description

OPENAI_API_KEY	sk-xxxxxx	Your OpenAI API key (required)
----🧭 Personality Modes

You can switch between personalities during chat:

🌿 Serene Listener — calm, slow, deeply empathetic

🌞 Uplifting Friend — cheerful, hopeful, talkative

🌙 Reflective Soul — poetic, wise, deeply comforting

🌺 Gentle Mentor — spiritual, compassionate, thoughtful


Each personality has unique tone, phrasing, and energy.


---

⚠️ Mental Health Note

Serenity is here to support you emotionally, not replace professional help.
If you are in crisis or feel unsafe, please reach out for immediate help:

📞 International Helplines:

🇺🇸 US: 988 (Suicide & Crisis Lifeline)

🇬🇧 UK: Samaritans – 116 123

🇮🇳 India: AASRA – 91-9820466726

🌍 Find your local helpline here, anytime.



---

💖 Created With Love

Built to make the world a little kinder, one chat at a time.
Made by 💛 you — powered by OpenAI, Flask, and Hugging Face Spaces.