ashhal commited on
Commit
2e390c7
Β·
verified Β·
1 Parent(s): ac6f9e3

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +15 -27
README.md CHANGED
@@ -8,41 +8,29 @@ sdk_version: 1.44.1
8
  app_file: app.py
9
  pinned: false
10
  license: mit
11
- short_description: Quranic verses for every mood and emotion
12
-
13
  ---
14
 
15
  # πŸ“š Kalam Comfort
16
 
17
- **Kalam Comfort** is a spiritually reflective Streamlit app that offers Quranic comfort based on how you're feeling.
18
-
19
- Select an emotion β€” such as sadness, anxiety, gratitude, or loneliness β€” and the app presents a carefully chosen Quranic verse, a short tafsir (interpretation), and a heartfelt dua to reflect on.
20
-
21
- This app aims to help you reconnect with the divine message of the Quran in moments of emotional need β€” bringing clarity, peace, and purpose.
22
 
23
  ## 🌟 Features
24
 
25
- - Mood selector with 10+ emotional states
26
- - Quranic verse (Arabic & English) for each feeling
27
- - Brief tafsir (explanation)
28
- - Authentic dua (supplication) related to the emotion
29
- - Streamlit-powered UI
30
-
31
- ## πŸ›  Built With
32
 
33
- - `Streamlit`
34
- - `requests`
35
- - `Pillow`
36
- - `AlQuran.cloud API`
37
- - Optional: Firebase / Unsplash / dotenv
38
-
39
- ## πŸ•Š License
40
-
41
- This project is licensed under the MIT License.
42
-
43
- ---
44
 
45
- > ✨ May every verse bring you closer to peace. Built with faith, code, and reflection.
46
 
 
47
 
48
- Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
 
 
 
8
  app_file: app.py
9
  pinned: false
10
  license: mit
11
+ short_description: Quranic verses, Duas, and Hadiths for every mood and emotion
 
12
  ---
13
 
14
  # πŸ“š Kalam Comfort
15
 
16
+ **Kalam Comfort** is a spiritually enriching Streamlit app that offers Quranic guidance, Duas, and Hadiths tailored to your emotional state. Whether you’re feeling sad, anxious, grateful, or simply lost β€” the app delivers divine reminders to soothe the soul and strengthen your connection with Allah ο·».
 
 
 
 
17
 
18
  ## 🌟 Features
19
 
20
+ - 🎭 **Emotion-based content** – Choose from 10+ moods (sad, anxious, grateful, tired, etc.)
21
+ - πŸ•‹ **Quranic verses** – Handpicked ayahs with Arabic, English, and Urdu translations
22
+ - 🀲 **Relevant Duas** – Authentic, beautiful supplications in Arabic, English, and Urdu
23
+ - πŸ“œ **Inspirational Hadiths** – Uplifting Prophetic sayings for your heart and mind
24
+ - ✨ **Randomizer Button** – Click *"Show Another Response"* to cycle through more content
25
+ - πŸ“ **Reflection Journal** – Write and save personal reflections for each mood
26
+ - 🎨 **Clean UI** – Focused, minimalistic interface powered by Streamlit
27
 
28
+ ## πŸš€ Getting Started
 
 
 
 
 
 
 
 
 
 
29
 
30
+ This app runs in your browser – no installation required. Simply [launch it on Hugging Face Spaces](https://huggingface.co/spaces/ashhal/Kalam_Comfort).
31
 
32
+ If running locally:
33
 
34
+ ```bash
35
+ pip install streamlit requests
36
+ streamlit run app.py