ashhal commited on
Commit
fa907c9
Β·
verified Β·
1 Parent(s): 841ae3f

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +37 -3
README.md CHANGED
@@ -3,12 +3,46 @@ title: Kalam Comfort
3
  emoji: πŸ“š
4
  colorFrom: purple
5
  colorTo: purple
6
- sdk: gradio
7
- sdk_version: 5.36.2
8
  app_file: app.py
9
  pinned: false
10
  license: mit
11
- short_description: 'A soulful app that gently guides you to a Quranic verse for '
 
12
  ---
13
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
14
  Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
 
3
  emoji: πŸ“š
4
  colorFrom: purple
5
  colorTo: purple
6
+ sdk: streamlit
7
+ 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