Hub documentation
استخدام Keras في Hugging Face
استخدام Keras في Hugging Face
Keras هو إطار عمل مفتوح المصدر لتعلم العميق متعدد الخلفيات، يدعم JAX وTensorFlow وPyTorch. يمكنك العثور على مزيد من التفاصيل عنه على keras.io.
استكشاف Keras في Hub
يمكنك سرد نماذج keras على Hub عن طريق التصفية حسب اسم المكتبة في صفحة النماذج.
تتمتع نماذج Keras على Hub بميزات مفيدة عند رفعها مباشرةً من مكتبة Keras:
- بطاقة نموذج مُولّدة تتضمن وصفًا، ورسمًا بيانيًا للنموذج، والمزيد.
- عدد التحميلات لمراقبة شعبية النموذج.
- مقطع كود للبدء السريع مع النموذج.
استخدام نماذج موجودة
Keras مُدمج بعمق مع Hugging Face Hub. وهذا يعني أنه يمكنك تحميل النماذج وحفظها على Hub مباشرةً من المكتبة. للقيام بذلك، تحتاج إلى تثبيت إصدار حديث من Keras وhuggingface_hub. تُستخدم مكتبة huggingface_hub كعميل Python خفيف الوزن من قِبل Keras للتفاعل مع Hub.
pip install -U keras huggingface_hubبمجرد تثبيت المكتبة، ما عليك سوى استخدام طريقة keras.saving.load_model العادية عن طريق تمرير مسار Hugging Face كحجة. مسار HF هو repo_id مُسبق بـ hf:// على سبيل المثال "hf://keras-io/weather-prediction". اقرأ المزيد عن load_model في توثيق Keras.
import keras
model = keras.saving.load_model("hf://Wauplin/mnist_example")إذا كنت ترغب في معرفة كيفية تحميل نموذج محدد، يمكنك النقر على استخدم هذا النموذج في صفحة النموذج للحصول على مقتطف كود جاهز للاستخدام!
مشاركة نماذجك
وبنفس الطريقة التي تعمل بها load_model، يمكنك حفظ نموذج keras ومشاركته على Hub باستخدام model.save() مع مسار HF:
model = ...
model.save("hf://your-username/your-model-name")إذا لم يكن المستودع موجودًا على Hub، فسيتم إنشاؤه لك. يحتوي النموذج المُحمَّل على بطاقة نموذج، ورسم بياني للنموذج، وملفَي metadata.json وconfig.json، وملف model.weights.h5 يحتوي على أوزان النموذج.
بشكل افتراضي، ستحتوي المستودع على بطاقة نموذج أساسية. اطّلع على دليل بطاقة النموذج لمعرفة المزيد حول بطاقات النماذج وكيفية إكمالها. كما يمكنك تحديث بطاقات النماذج برمجياً باستخدام huggingface_hub.ModelCard (انظر الدليل).
ربما تكون على دراية بالفعل بملفات
.keras. في الواقع، ملف.kerasهو ببساطة ملف مضغوط يحتوي على ملفات.jsonوmodel.weights.h5. عند رفع النموذج إلى Hub، يُحفظ النموذج كمجلد غير مضغوط لتتمكن من التنقل بين الملفات. لاحظ أنه إذا قمت برفع ملف.kerasيدويًا إلى مستودع نموذج على Hub، فسيتم وسم المستودع تلقائيًا بوسمkerasلكنك لن تتمكن من تحميله باستخدامkeras.saving.load_model.