Update README.md

README.md

@@ -1,16 +1,95 @@
+🌸 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.
+
+
 ---
-title: Serenity Chatbot 4.5
-emoji: 💬
-colorFrom: yellow
-colorTo: purple
-sdk: gradio
-sdk_version: 5.42.0
-app_file: app.py
-pinned: false
-hf_oauth: true
-hf_oauth_scopes:
-- inference-api
-short_description: This is a great ai chatbot,who responds with love,care.
+
+🛠️ 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
+
+
+
 ---
 
-An example chatbot using [Gradio](https://gradio.app), [`huggingface_hub`](https://huggingface.co/docs/huggingface_hub/v0.22.2/en/index), and the [Hugging Face Inference API](https://huggingface.co/docs/api-inference/index).
+⚙️ 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.