Hướng dẫn bắt đầu

Để bắt đầu, bạn có thể chạy một ví dụ đơn giản ghi lại một số chỉ số huấn luyện giả lập:

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()

Chạy lệnh trên sẽ in ra các hướng dẫn để khởi động bảng điều khiển trong terminal.

Cách sử dụng trackio được thiết kế để giống hệt với wandb trong hầu hết các trường hợp, vì vậy bạn có thể dễ dàng chuyển đổi giữa hai thư viện này.

import trackio as wandb

Bảng điều khiển

Bạn có thể khởi chạy bảng điều khiển bằng cách chạy:

trackio show

import trackio

trackio.show()

Bạn cũng có thể cung cấp tên project tùy chọn làm đối số để tải trực tiếp một dự án cụ thể:

trackio show --project "my-project"

import trackio 

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

Triển khai đến Hugging Face Spaces

Khi gọi trackio.init(), mặc định dịch vụ sẽ chạy cục bộ và lưu trữ dữ liệu dự án trên máy cục bộ.

Nhưng nếu bạn truyền space_id vào init(), như:

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

hoặc

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

nó sẽ sử dụng một Hugging Face Space hiện có hoặc tự động triển khai một Space mới khi cần. Bạn cần đã đăng nhập bằng huggingface-cli trên máy cục bộ và token của bạn phải có quyền ghi để tạo Space.

Hoặc bạn có thể đồng bộ hóa một dự án cục bộ hiện có với một Hugging Face Space bằng cách chạy:

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

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

Thao tác này sẽ tạo Space nếu nó chưa tồn tại, và tải lên tất cả các run cùng dữ liệu liên quan lên Space. Bạn cũng có thể đồng bộ hóa với một Space tĩnh nhẹ bằng sdk="static", hoặc tạo một bản sao chỉ đọc của một Space đang hoạt động bằng freeze. Một Space đã đóng băng là bản sao tại một thời điểm cụ thể và sẽ không nhận các chỉ số mới từ Gradio Space gốc trừ khi bạn đóng băng lại. Xem trang Deploy and Embed Dashboards để biết thêm chi tiết.