دليل البدء السريع

للبداية، يمكنك تشغيل مثال بسيط يسجّل بعض مقاييس التدريب الوهمية:

import trackio
import random
import time

runs = 3
epochs = 8


for run in range(runs):
    trackio.init(
        project="my-project",
        config={"epochs": epochs, "learning_rate": 0.001, "batch_size": 64}
    )

    for epoch in range(epochs):
        train_loss = random.uniform(0.2, 1.0)
        train_acc = random.uniform(0.6, 0.95)

        val_loss = train_loss - random.uniform(0.01, 0.1)
        val_acc = train_acc + random.uniform(0.01, 0.05)

        trackio.log({
            "epoch": epoch,
            "train_loss": train_loss,
            "train_accuracy": train_acc,
            "val_loss": val_loss,
            "val_accuracy": val_acc
        })

        time.sleep(0.2)

trackio.finish()

عند تشغيل الأمر أعلاه، ستُطبع في الطرفية تعليمات حول كيفية تشغيل لوحة التحكم.

تم تصميم استخدام trackio ليكون مطابقاً لاستخدام wandb في معظم الحالات، مما يتيح لك التبديل بسهولة بين المكتبتين.

import trackio as wandb

لوحة التحكم

يمكنك تشغيل لوحة التحكم من خلال تنفيذ الأمر التالي:

trackio show

import trackio

trackio.show()

يمكنك أيضًا تقديم اسم project اختياري كحِجّة لتحميل مشروع محدد مباشرةً:

trackio show --project "my-project"

import trackio 

trackio.show(project="my-project")

النشر على Hugging Face Spaces

عند استدعاء trackio.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) يحمل صلاحيات الكتابة لإنشاء المساحة.

بديلًا عن ذلك، يمكنك مزامنة مشروع محلي موجود مع مساحة Hugging Face من خلال تشغيل الأمر التالي:

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

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

سيؤدي هذا إلى إنشاء المساحة إذا لم تكن موجودة بالفعل، ورفع جميع التشغيلات والبيانات المرتبطة بها إلى المساحة. يمكنك أيضًا المزامنة مع مساحة ثابتة خفيفة باستخدام sdk="static"، أو إنشاء لقطة للقراءة فقط لمساحة نشطة باستخدام freeze. المساحة المجمّدة هي لقطة في نقطة زمنية محددة ولن تستوعب المقاييس اللاحقة من مساحة Gradio الأصلية ما لم تُجمِّد مرة أخرى. راجع صفحة Deploy and Embed Dashboards لمزيد من التفاصيل.