نشر لوحات المعلومات وتضمينها

النشر على Hugging Face Spaces

عند استدعاء init()، سيعمل الخدمة محليًا بشكل افتراضي وتخزين بيانات المشروع على الجهاز المحلي.

لكن إذا مررت space_id إلى init()، على النحو التالي:

trackio.init(project="my-project", space_id="orgname/space_id")

أو

trackio.init(project="my-project", space_id="username/space_id")

سيستخدم مساحة Hugging Face موجودة أو ينشر مساحة جديدة تلقائيًا عند الحاجة. يجب أن تكون مسجّل الدخول محليًا باستخدام huggingface-cli وأن يكون لديك رمز وصول (token) يحمل صلاحيات الكتابة لإنشاء المساحة.

مزامنة المشاريع المحلية مع مساحات

إذا كنت تسجّل محليًا وتريد رفع بياناتك إلى مساحة بعد ذلك، استخدم sync:

trackio.sync(project="my-project", space_id="username/space_id")

أو من سطر الأوامر:

trackio sync --project "my-project" --space-id "username/space_id"

بشكل افتراضي، ينشر sync مساحة Gradio Space مع خادم مباشر. يمكنك أيضاً نشر مساحة ثابتة تقرأ من حاوية HF (لا حاجة إلى خادم):

trackio.sync(project="my-project", space_id="username/space_id", sdk="static")

trackio sync --project "my-project" --space-id "username/space_id" --sdk static

مساحات Static Spaces خفيفة الوزن ومجانية — فهي تقدّم لوحة تحكم للقراءة فقط مدعومة بملفات Parquet في حاوية HF Bucket. وبما أن لوحة التحكم تعمل بالكامل داخل المتصفح، فإن مساحات Trackio الثابتة تتطلب بيانات لقطة عامة ولا تدعم private=True. استخدم مساحة Gradio الافتراضية (sdk="gradio") للوحات التحكم الخاصة.

تجميد لقطة مساحة

إذا كان لديك مساحة Gradio نشطة وتريد إنشاء لقطة ثابتة للقراءة فقط لبيانات مشروع، فاستخدم freeze:

trackio.freeze(space_id="username/my-space", project="my-project")

أو من سطر الأوامر:

trackio freeze --space-id "username/my-space" --project "my-project"

يؤدي هذا إلى إنشاء مساحة ثابتة جديدة (تُسمّى افتراضياً {space_id}_static) تحتوي على لقطة من بيانات المشروع من حاوية المساحة المصدرية. لا يتم تعديل المساحة الأصلية.

لاحظ أن freeze() هي لقطة فورية تُلتقط مرة واحدة. إذا تم رفع مقاييس جديدة لاحقًا إلى مساحة Gradio الأصلية، فلن يتم تحديث المساحة الثابتة المجمّدة تلقائيًا. يمكن لمساحة Gradio المصدر استخدام دلو خاص، لكن اللقطة الثابتة المجمّدة هي بيانات عامة. لا يُدعم freeze(private=True)؛ استخدم مساحة Gradio إذا كان لا بد من بقاء لوحة المعلومات المجمّدة خاصة.

يمكنك تخصيص الوجهة:

trackio.freeze(
    space_id="username/my-space",
    project="my-project",
    new_space_id="username/my-snapshot",
)

ملاحظة: يتطلب freeze() أن يكون المصدر مساحة Gradio مع وجود دلو (bucket) مُثبَّت في /data. إذا كانت مساحة الوجهة موجودة مسبقًا وليست مساحة Trackio ثابتة، فسيرفض freeze() تجاوزها.

تضمين لوحة تحكم Trackio

من الأسباب التي دفعتنا إلى إنشاء trackio هو تسهيل تضمين لوحات معلومات حية على المواقع الإلكترونية أو المدونات أو أي مكان آخر يمكن فيه تضمين موقع ويب.

إذا كان لوحة تحكم Trackio الخاصة بك مستضافة على Spaces، يمكنك تضمينها في أي مكان باستخدام <iframe>:

<iframe src="https://username-space_id.hf.space"></iframe>

يمكنك أيضًا تصفية لوحة التحكم لعرض مشاريع أو مقاييس محددة فقط باستخدام معاملات الاستعلام. تشمل المعلمات المدعومة:

• project (نص): عرض مشروع محدد فقط.

• metrics (قائمة مفصولة بفواصل): عرض مقاييس محددة فقط، على سبيل المثال train_loss,train_accuracy.

• sidebar (نوع string، "auto"، "visible"، "collapsed"، أو "hidden"):

  • "auto" يفتح الشريط الجانبي أو يطويه بناءً على عرض نافذة العرض، وهو الإعداد الافتراضي.
  • "visible" يبدأ مع فتح الشريط الجانبي بالكامل.
  • "collapsed" يبدأ بالشريط الضيق فقط.
  • "hidden" يُخفي الشريط الجانبي بالكامل.

  لا تتغير الأوضاع الصريحة عند تغيير حجم نافذة العرض.

• footer (string, "false"): عند ضبطه على "false"، يُخفي تذييل Gradio. بشكل افتراضي، يكون التذييل مرئيًا.

• xmin (number): تحديد الحد الأدنى الأولي لقيم محور السينات في جميع رسوم المؤشرات.

• xmax (number): تحديد الحد الأقصى الأولي لقيم محور السينات في جميع رسوم المؤشرات.

• smoothing (عدد): تعيين القيمة الأولية لمنزلق التنعيم (0-20، حيث 0 = بدون تنعيم).

• plots_per_row (auto أو عدد صحيح من 1 إلى 6): يحدد القيمة الأولية للتحكم Plots per row. القيمة الافتراضية هي auto، والتي تجعل المخططات تتناسب مع العرض المتاح.

• accordion (string, "hidden"): عند ضبطه على "hidden"، يُخفي رؤوس الأقسام المنسدلة المحيطة بمجموعات المقاييس. بشكل افتراضي، تكون رؤوس الأقسام مرئية.

يمكنك تخصيص <iframe> باستخدام سمات قياسية مثل width وheight وstyle. لمزيد من التفاصيل، راجع MDN Web Docs: <iframe>. على سبيل المثال:

<iframe 
    src="https://trackio-documentation.hf.space/?project=my-project&metrics=train_loss,train_accuracy&sidebar=hidden" 
    width="600" 
    height="630" 
    style="border:0;">
</iframe>