Upload README.md with huggingface_hub

README.md

@@ -1,12 +1,37 @@
 ---
-title: Kaeva Factcheck
-emoji: 📈
+title: Kaeva Fact-Check
+emoji: 🔍
 colorFrom: indigo
-colorTo: yellow
+colorTo: purple
 sdk: gradio
-sdk_version: 6.6.0
+sdk_version: 4.44.1
 app_file: app.py
-pinned: false
+pinned: true
+license: mit
+short_description: Two-stage AI fact-checking with DeBERTa + Gemini Search
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# Kaeva Fact-Check
+
+Two-stage AI fact-checking pipeline:
+
+1. **Stage 1 — DeBERTa Classifier**: Instant binary detection (real vs fake news)
+2. **Stage 2 — Gemini + Google Search**: Live evidence verification with cited sources
+
+## API Usage
+
+```python
+import requests
+
+# Single claim
+resp = requests.post("https://Vi0509-kaeva-factcheck.hf.space/api/check", json={
+    "claim": "The Earth is flat.",
+    "force_search": False
+})
+print(resp.json())
+
+# Batch (up to 20)
+resp = requests.post("https://Vi0509-kaeva-factcheck.hf.space/api/batch", json={
+    "claims": ["Claim 1", "Claim 2"]
+})
+```