Mendeploy dan Menanamkan Dasbor

Mendeploy ke Hugging Face Spaces

Saat memanggil init(), secara default layanan akan berjalan secara lokal dan menyimpan data proyek di mesin lokal.

Tetapi jika Anda meneruskan space_id ke init(), seperti:

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

atau

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

it will use an existing or automatically deploy a new Hugging Face Space as needed. Anda harus sudah masuk menggunakan huggingface-cli secara lokal dan token Anda harus memiliki izin tulis untuk membuat Space.

Menyinkronkan Proyek Lokal ke Spaces

Jika Anda telah mencatat data secara lokal dan ingin mengunggahnya ke Space setelahnya, gunakan sync:

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

Atau dari CLI:

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

Secara default, sync mendeploy Gradio Space dengan server live. Anda juga dapat mendeploy static Space yang membaca dari HF Bucket (tanpa server):

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 bersifat ringan dan gratis — mereka menyajikan dasbor hanya-baca yang didukung oleh file Parquet di HF Bucket. Karena dasbor berjalan sepenuhnya di browser, Trackio Spaces statis memerlukan data snapshot publik dan tidak mendukung private=True. Gunakan Gradio Space default (sdk="gradio") untuk dasbor privat.

Membekukan Snapshot Space

Jika Anda memiliki Gradio Space yang aktif dan ingin membuat snapshot statis read-only dari data proyek, gunakan freeze:

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

Atau dari CLI:

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

Hal ini membuat Space statis baru (secara default bernama {space_id}_static) yang berisi snapshot data proyek dari bucket Space sumber. Space asli tidak diubah.

Perhatikan bahwafreeze() adalah snapshot sekali jalan. Jika metrik baru diunggah kemudian ke Gradio Space asli, Gradio Space statis yang dibekukan tidak akan diperbarui secara otomatis. Gradio Space sumber dapat menggunakan bucket privat, tetapi snapshot statis yang dibekukan adalah data publik. freeze(private=True) tidak didukung; gunakan Gradio Space jika dasbor yang dibekukan harus tetap privat.

Anda dapat menyesuaikan tujuan:

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

Catatan: freeze() mensyaratkan sumber berupa Gradio Space dengan bucket yang dipasang di /data. Jika Space tujuan sudah ada dan bukan Trackio static Space, freeze() akan menolak untuk menimpanya.

Menanamkan Dasbor Trackio

Salah satu alasan kami membuat trackio adalah untuk memudahkan penanaman dashboard langsung di situs web, artikel blog, atau di mana pun Anda dapat menanamkan situs web.

Jika dashboard Trackio Anda dihosting di Spaces, Anda dapat menyematkannya di mana saja menggunakan <iframe>:

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

Anda juga dapat memfilter dasbor untuk menampilkan hanya proyek atau metrik tertentu menggunakan parameter kueri. Parameter yang didukung meliputi:

• project (string): Tampilkan hanya proyek tertentu.

• metrics (daftar dipisahkan koma): Tampilkan hanya metrik tertentu, misalnya train_loss,train_accuracy.

• sidebar (string, "auto", "visible", "collapsed", atau "hidden"):

  • "auto" membuka atau melipat bilah samping berdasarkan lebar viewport dan merupakan nilai default.
  • "visible" dimulai dengan sidebar penuh yang terbuka.
  • "collapsed" dimulai hanya dengan rel sempit.
  • "hidden" menyembunyikan bilah sisi sepenuhnya.

  Mode eksplisit tidak berubah saat viewport di-resize.

• footer (string, "false"): Jika diatur ke "false", footer Gradio akan disembunyikan. Secara default, footer terlihat.

• xmin (number): Menetapkan nilai minimum awal untuk batas sumbu x di semua plot metrik.

• xmax (number): Menetapkan nilai maksimum awal untuk batas sumbu x di semua plot metrik.

• smoothing (angka): Menetapkan nilai awal slider smoothing (0-20, di mana 0 = tanpa smoothing).

• plots_per_row (auto atau bilangan bulat dari 1 hingga 6): Menetapkan nilai awal untuk kontrol Plots per row. Nilainya secara bawaan adalah auto, yang menyesuaikan plot dengan lebar yang tersedia.

• accordion (string, "hidden"): Ketika diatur ke "hidden", menyembunyikan header bagian accordion di sekitar grup metrik. Secara default, header bagian terlihat.

Anda dapat menyesuaikan <iframe> menggunakan atribut standar seperti width, height, dan style. Untuk detail lebih lanjut, lihat MDN Web Docs: <iframe>. Sebagai contoh:

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