Spaces:
Running
A newer version of the Gradio SDK is available:
6.0.1
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.