Update README.md

README.md

@@ -1,10 +1,74 @@
 ---
-title: Timing Optimizer
-emoji: 🐨
+title: FomoFeed Timing Optimizer
+emoji: ⏰
 colorFrom: purple
-colorTo: green
+colorTo: pink
 sdk: docker
 pinned: false
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# FomoFeed Timing Optimizer AI
+
+AI-powered optimal posting time prediction based on engagement patterns.
+
+## 🎯 Purpose
+Analyzes user's historical engagement data to recommend the best time to post content.
+
+## 📥 Input
+- User ID
+- Engagement history (hours when content received engagement)
+- Engagement weights (view=1, like=3, comment=5, save=7)
+- Content type (post/moment)
+
+## 📤 Output
+```json
+{
+  "optimal_hour": 19,
+  "confidence": 0.87,
+  "alternative_hours": [20, 18, 21, 13],
+  "reasoning": {
+    "method": "weighted_pattern_analysis",
+    "total_engagements": 142,
+    "data_quality": "good"
+  }
+}
+```
+
+## 🚀 Usage
+
+### Get Optimal Hour
+```bash
+curl -X POST "https://YOUR-SPACE-URL/predict" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "user_id": 12,
+    "engagement_hours": [19, 20, 13, 19, 21, 18],
+    "engagement_weights": [1, 3, 1, 5, 3, 1],
+    "content_type": "post"
+  }'
+```
+
+### Get Next Opportunities (48h)
+```bash
+curl -X POST "https://YOUR-SPACE-URL/next_opportunities?count=5" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "user_id": 12,
+    "engagement_hours": [19, 20, 13],
+    "engagement_weights": [3, 5, 1]
+  }'
+```
+
+## 🧠 Algorithm
+1. Analyzes weighted distribution of engagement hours
+2. Applies time-of-day bonuses (lunch, evening peaks)
+3. Smooths distribution using neighboring hours
+4. Calculates confidence based on data volume
+5. Returns optimal hour + alternatives
+
+## 📊 Performance
+- Latency: <50ms
+- Confidence: 0.3-0.95 (increases with more data)
+- Timezone-aware (Turkey UTC+3)
+
+Built with FastAPI + NumPy