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

[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/gradio-app/trackio/blob/main/examples/notebooks/quickstart.ipynb)

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

```python
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` في معظم الحالات، مما يتيح لك التبديل بسهولة بين المكتبتين.

```py
import trackio as wandb
```

## لوحة التحكم

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

```sh
trackio show
```

```py
import trackio

trackio.show()
```

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

```sh
trackio show --project "my-project"
```

```py
import trackio 

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

## النشر على Hugging Face Spaces

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

لكن إذا مررت `space_id` إلى [init()](/docs/trackio/v0.45.0/ar/api#trackio.init)، على النحو التالي:

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

أو

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

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

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

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

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

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