metadata

title: LetterboxdRecommender
emoji: 🦀
colorFrom: red
colorTo: blue
sdk: gradio
sdk_version: 5.29.0
app_file: app.py
pinned: false
license: apache-2.0

🎬 رفيقك السينمائي 🍿 (Your Cinematic Companion)

مرحباً بك يا سلمان في رفيقك السينمائي الشخصي!

هذا التطبيق مصمم خصيصاً لك، ويستخدم بياناتك من Letterboxd ليقدم لك توصيات أفلام جديدة وممتعة. والأحلى من كذا؟ كل توصية تجي مع شرح صغير باللهجة السعودية العامية، يوضح لك ليش الفيلم هذا ممكن يعجبك بناءً على الأفلام اللي حبيتها قبل!

✨ كيف يشتغل؟

بياناتك هي الأساس: التطبيق يقرأ أفلامك اللي شفتها، تقييماتك، وحتى مفضلاتك من ملفات CSV اللي صدرتها من حسابك في Letterboxd.
ذكاء TMDB: نستخدم واجهة برمجة تطبيقات TMDB (The Movie Database) عشان نلاقي تفاصيل الأفلام ونجيب لك توصيات مشابهة للأفلام اللي عجبتك.
لمسة الذكاء الاصطناعي باللهجة السعودية: هنا تجي المتعة! نستخدم نموذج لغوي متطور (مثل Mistral-7B) عشان يكتب لك شرح لكل فيلم مرشح باللهجة السعودية، ويربطه بفيلم شفته وحبيته. الشرح يكون خفيف ومضحك وشخصي.
واجهة سهلة وممتعة: كل هذا معروض لك بواجهة بسيطة وسهلة الاستخدام عن طريق Gradio.

🚀 كيف تستخدمه؟

بكل بساطة:

تأكد إنك رفعت كل ملفات الـ CSV الخاصة ببياناتك في Letterboxd (مثل reviews.csv, diary.csv, ratings.csv, watchlist.csv, watched.csv, comments.csv, profile.csv) إلى هذا الـ Space.
تأكد إنك أضفت مفتاح TMDB API الخاص بك كـ "Secret" في إعدادات الـ Space باسم TMDB_API_KEY.
اضغط على زر "يا سلمان، عطني توصيات أفلام!".
انتظر شوي... التطبيق بيحلل بياناتك ويكلم الذكاء الاصطناعي.
استمتع بالتوصيات والشرح الرهيب!

🛠️ التقنيات المستخدمة:

Python
Pandas (لمعالجة البيانات)
Requests (للتواصل مع TMDB API)
BeautifulSoup4 (لتنظيف النصوص)
Hugging Face Transformers (لتشغيل نموذج الذكاء الاصطناعي)
PyTorch
Gradio (لبناء الواجهة التفاعلية)
TMDB API

📝 ملاحظات:

أول مرة تشغل فيها التطبيق أو تضغط على الزر، ممكن ياخذ وقت أطول شوي لأن نموذج الذكاء الاصطناعي الكبير يحتاج وقت عشان يتحمل ويشتغل. المرات اللي بعدها بتكون أسرع.
جودة التوصيات تعتمد على بياناتك في Letterboxd وعلى اقتراحات TMDB.
الشرح باللهجة السعودية يتم توليده بواسطة الذكاء الاصطناعي، فممكن تشوف بعض الجمل الغريبة أحياناً، بس هذا جزء من متعة التجربة! 😄

نتمنى لك مشاهدة ممتعة مع توصيات "رفيقك السينمائي"! 🎥

تطوير: (اسمك أو اسم مستعار لك هنا إذا أردت) بمساعدة: نموذج لغوي من Hugging Face و TMDB API

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference