Spaces:
Sleeping
Sleeping
Update README.md
Browse files
README.md
CHANGED
|
@@ -9,5 +9,52 @@ app_file: app.py
|
|
| 9 |
pinned: false
|
| 10 |
license: apache-2.0
|
| 11 |
---
|
|
|
|
| 12 |
|
| 13 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 9 |
pinned: false
|
| 10 |
license: apache-2.0
|
| 11 |
---
|
| 12 |
+
# 🎬 رفيقك السينمائي 🍿 (Your Cinematic Companion)
|
| 13 |
|
| 14 |
+
مرحباً بك يا سلمان في رفيقك السينمائي الشخصي!
|
| 15 |
+
|
| 16 |
+
هذا التطبيق مصمم خصيصاً لك، ويستخدم بياناتك من Letterboxd ليقدم لك توصيات أفلام جديدة وممتعة. والأحلى من كذا؟ كل توصية تجي مع شرح صغير باللهجة السعودية العامية، يوضح لك ليش الفيلم هذا ممكن يعجبك بناءً على الأفلام اللي حبيتها قبل!
|
| 17 |
+
|
| 18 |
+
## ✨ كيف يشتغل؟
|
| 19 |
+
|
| 20 |
+
1. **بياناتك هي الأساس**: التطبيق يقرأ أفلامك اللي شفتها، تقييماتك، وحتى مفضلاتك من ملفات CSV اللي صدرتها من حسابك في Letterboxd.
|
| 21 |
+
2. **ذكاء TMDB**: نستخدم واجهة برمجة تطبيقات TMDB (The Movie Database) عشان نلاقي تفاصيل الأفلام ونجيب لك توصيات مشابهة للأفلام اللي عجبتك.
|
| 22 |
+
3. **لمسة الذكاء الاصطناعي باللهجة السعودية**: هنا تجي المتعة! نستخدم نموذج لغوي متطور (مثل Mistral-7B) عشان يكتب لك شرح لكل فيلم مرشح باللهجة السعودية، ويربطه بفيلم شفته وحبيته. الشرح يكون خفيف ومضحك وشخصي.
|
| 23 |
+
4. **واجهة سهلة وممتعة**: كل هذا معروض لك بواجهة بسيطة وسهلة الاستخدام عن طريق Gradio.
|
| 24 |
+
|
| 25 |
+
## 🚀 كيف تستخدمه؟
|
| 26 |
+
|
| 27 |
+
بكل بساطة:
|
| 28 |
+
|
| 29 |
+
1. تأكد إنك رفعت كل ملفات الـ CSV الخاصة ببياناتك في Letterboxd (مثل `reviews.csv`, `diary.csv`, `ratings.csv`, `watchlist.csv`, `watched.csv`, `comments.csv`, `profile.csv`) إلى هذا الـ Space.
|
| 30 |
+
2. تأكد إنك أضفت مفتاح TMDB API الخاص بك كـ "Secret" في إعدادات الـ Space باسم `TMDB_API_KEY`.
|
| 31 |
+
3. اضغط على زر "**يا سلمان، عطني توصيات أفلام!**".
|
| 32 |
+
4. انتظر شوي... التطبيق بيحلل بياناتك ويكلم الذكاء الاصطناعي.
|
| 33 |
+
5. استمتع بالتوصيات والشرح الرهيب!
|
| 34 |
+
|
| 35 |
+
## 🛠️ التقنيات المستخدمة:
|
| 36 |
+
|
| 37 |
+
* Python
|
| 38 |
+
* Pandas (لمعالجة البيانات)
|
| 39 |
+
* Requests (للتواصل مع TMDB API)
|
| 40 |
+
* BeautifulSoup4 (لتنظيف النصوص)
|
| 41 |
+
* Hugging Face Transformers (لتشغيل نموذج الذكاء الاصطناعي)
|
| 42 |
+
* PyTorch
|
| 43 |
+
* Gradio (لبناء الواجهة التفاعلية)
|
| 44 |
+
* TMDB API
|
| 45 |
+
|
| 46 |
+
## 📝 ملاحظات:
|
| 47 |
+
|
| 48 |
+
* أول مرة تشغل فيها التطبيق أو تضغط على الزر، ممكن ياخذ وقت أطول شوي لأن نموذج الذكاء الاصطناعي الكبير يحتاج وقت عشان يتحمل ويشتغل. المرات اللي بعدها بتكون أسرع.
|
| 49 |
+
* جودة التوصيات تعتمد على بياناتك في Letterboxd وعلى اقتراحات TMDB.
|
| 50 |
+
* الشرح باللهجة السعودية يتم توليده بواسطة الذكاء الاصطناعي، فممكن تشوف بعض الجمل الغريبة أحياناً، بس هذا جزء من متعة التجربة! 😄
|
| 51 |
+
|
| 52 |
+
نتمنى لك مشاهدة ممتعة مع توصيات "رفيقك السينمائي"! 🎥
|
| 53 |
+
|
| 54 |
+
---
|
| 55 |
+
|
| 56 |
+
*تطوير: (اسمك أو اسم مستعار لك هنا إذا أردت)*
|
| 57 |
+
*بمساعدة: نموذج لغوي من Hugging Face و TMDB API*
|
| 58 |
+
---
|
| 59 |
+
|
| 60 |
+
Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
|