File size: 2,504 Bytes
9fc1e96
 
 
 
 
 
 
 
19c1682
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
724a9f2
19c1682
 
 
 
 
 
 
 
 
 
 
 
 
 
724a9f2
 
19c1682
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
---
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.