Create app.py

app.py

@@ -0,0 +1,177 @@
+import os
+import re
+import gradio as gr
+from openai import OpenAI
+
+HF_TOKEN = os.environ.get("HF_TOKEN")
+MODEL_ID = "Qwen/Qwen2.5-7B-Instruct"
+
+if not HF_TOKEN:
+    raise ValueError("HF_TOKEN is missing. Add it in Space Settings -> Secrets.")
+
+client = OpenAI(
+    base_url="https://router.huggingface.co/v1",
+    api_key=HF_TOKEN,
+)
+
+FINAL_NOTE = "Responses are generated from retrieved hadith evidence and the system is still under improvement."
+
+SYSTEM_PROMPT = """
+You are Hadithi AI, a professional assistant for explaining retrieved hadith evidence.
+
+The user's message already includes the retrieved hadith evidence from the API.
+Your job is to explain that evidence clearly, naturally, and faithfully.
+
+You must base your answer only on the hadiths provided in the user's message.
+Do not invent extra hadiths, extra sources, or unsupported claims.
+
+STRICT OUTPUT FORMAT:
+Write the final answer in exactly this order:
+
+Answer:
+Write exactly one polished explanatory paragraph in English unless the user clearly asks for Arabic.
+The paragraph must:
+- begin naturally in a style like: "The retrieved hadiths show that..."
+- explain the meaning of the retrieved hadiths in a smooth, human, article-like way
+- mention short Arabic phrases from the hadith only when useful
+- include the meaning of the Arabic phrase naturally in the sentence
+- avoid bullets
+- avoid robotic summary language
+- avoid repeating the same point
+- avoid quoting full hadiths
+- stay grounded in the actual retrieved evidence only
+
+Hadith Evidence:
+After the paragraph, list the hadiths provided by the user.
+For each hadith, use exactly this structure:
+
+- Source: ...
+- Grade: ...
+- Why it matters: ...
+- Text: ...
+
+FINAL LINE:
+End with this exact sentence:
+Responses are generated from retrieved hadith evidence and the system is still under improvement.
+
+IMPORTANT RULES:
+- Do not create extra headings such as Main Insight, Key meanings, or What the Hadiths Show.
+- Do not separate Arabic and English into different blocks in the Answer section.
+- Keep full Arabic hadith text only in the Hadith Evidence section.
+- If the evidence only partially answers the question, say so clearly.
+- Be elegant, clear, modern, and trustworthy.
+
+EXAMPLE STYLE FOR THE ANSWER SECTION:
+The retrieved hadiths show that mercy (raḥma / الرحمة) in Islam is both a divine attribute and a quality believers should live by. In one hadith, the Prophet ﷺ teaches a duʿā’ that ends with “forgive me … and have mercy on me” (“فاغفر لي … وارحمني”), showing that a Muslim constantly needs Allah’s mercy in addition to forgiveness. Another hadith connects mercy with healing through the supplication “place Your mercy on earth” (“فاجعل رحمتك في الأرض”), which presents mercy as something that brings relief and cure. The Prophet ﷺ also said, “Mercy is not removed except from one who is truly wretched” (“لا تنزع الرحمة إلا من شقي”), which shows that mercy is a sign of goodness in the heart, while losing it reflects spiritual hardness. The clearest summary appears in the hadith, “The merciful are shown mercy by the Most Merciful” (“الراحمون يرحمهم الرحمن”), teaching that those who show mercy to people receive mercy from Allah. Together, these hadiths present mercy as something to seek from Allah, to embody in the heart, and to extend to others.
+""".strip()
+
+
+def is_arabic_request(text: str) -> bool:
+    if not text:
+        return False
+    return bool(re.search(r'[\u0600-\u06FF]', text))
+
+
+def normalize_quotes(text: str) -> str:
+    if not text:
+        return ""
+    text = text.replace("“", '"').replace("”", '"')
+    text = text.replace("‘", "'").replace("’", "'")
+    return text
+
+
+def clean_answer(text: str, user_message: str = "") -> str:
+    if not text:
+        return ""
+
+    text = normalize_quotes(text.strip())
+
+    replacements = {
+        "Answer Insight:": "Answer:",
+        "Short answer:": "Answer:",
+        "Main Insight:": "Answer:",
+        "Key Finding:": "Answer:",
+        "Supporting Hadiths:": "Hadith Evidence:",
+        "Referenced Hadiths:": "Hadith Evidence:",
+        "What the Hadiths Show:": "Hadith Evidence:",
+        "What the Hadiths Cover:": "Hadith Evidence:",
+        "Evidence:": "Hadith Evidence:",
+        "Hadiths:": "Hadith Evidence:",
+        "Closing Note:": FINAL_NOTE,
+        "Note:": FINAL_NOTE,
+    }
+
+    for old, new in replacements.items():
+        text = text.replace(old, new)
+
+    # Normalize headings if model outputs markdown headings
+    text = re.sub(r"(?im)^#+\s*answer\s*:?\s*$", "Answer:", text)
+    text = re.sub(r"(?im)^#+\s*hadith evidence\s*:?\s*$", "Hadith Evidence:", text)
+
+    # Remove numbering before headings
+    text = re.sub(r"(?im)^\s*\d+\.\s*(Answer:)", r"\1", text)
+    text = re.sub(r"(?im)^\s*\d+\.\s*(Hadith Evidence:)", r"\1", text)
+
+    # Remove duplicate final note before re-adding once
+    text = re.sub(rf"(?s)\n*{re.escape(FINAL_NOTE)}\s*$", "", text).strip()
+
+    # Reduce excessive blank lines
+    text = re.sub(r"\n{3,}", "\n\n", text).strip()
+
+    # Ensure Answer section exists
+    if "Answer:" not in text:
+        text = "Answer:\n" + text
+
+    # Ensure Hadith Evidence section exists
+    if "Hadith Evidence:" not in text:
+        text += "\n\nHadith Evidence:\n"
+
+    # If Arabic requested, lightly relabel only headings, keep body as model returned
+    if is_arabic_request(user_message):
+        text = text.replace("Answer:", "الجواب:")
+        text = text.replace("Hadith Evidence:", "الأحاديث المسترجعة:")
+
+    # Add final note once
+    text = text.rstrip() + "\n\n" + FINAL_NOTE
+    return text
+
+
+def chat(message, history):
+    messages = [{"role": "system", "content": SYSTEM_PROMPT}]
+
+    for user_msg, assistant_msg in history:
+        if user_msg:
+            messages.append({"role": "user", "content": user_msg})
+        if assistant_msg:
+            messages.append({"role": "assistant", "content": assistant_msg})
+
+    messages.append({"role": "user", "content": message})
+
+    try:
+        response = client.chat.completions.create(
+            model=MODEL_ID,
+            messages=messages,
+            temperature=0.1,
+            max_tokens=1100,
+        )
+        answer = response.choices[0].message.content.strip()
+        answer = clean_answer(answer, user_message=message)
+    except Exception as e:
+        answer = f"Error: {str(e)}"
+
+    return answer
+
+
+demo = gr.ChatInterface(
+    fn=chat,
+    title="Hadithi AI",
+    description="Clear paragraph-based hadith answers followed by full hadith evidence",
+    textbox=gr.Textbox(
+        placeholder="Ask about a concept, meaning, value, or theme in hadith...",
+        container=True,
+        scale=7,
+    ),
+)
+
+if __name__ == "__main__":
+    demo.launch()