🟧 Label Studio di Spaces

Label Studio adalah platform pelabelan data open-source untuk melabeli, meng anotasi, dan mengeksplorasi berbagai jenis data. Selain itu, Label Studio juga menyediakan antarmuka machine learning yang powerful dan dapat digunakan untuk pelatihan model baru, active learning, supervised learning, serta berbagai teknik pelatihan lainnya.

Panduan ini akan mengajarkan Anda cara mendeploy Label Studio untuk pelabelan dan anotasi data di dalam Hugging Face Hub. Anda dapat menggunakan konfigurasi default Label Studio sebagai aplikasi mandiri yang di-host sepenuhnya di Hub menggunakan Docker untuk keperluan demonstrasi dan evaluasi, atau Anda dapat menempelkan database dan penyimpanan cloud Anda sendiri untuk meng-host aplikasi produksi yang lengkap di Spaces.

⚡️ Deploy Label Studio di Spaces

Anda dapat mendeploy Label Studio di Spaces hanya dengan beberapa klik:

Spaces mengharuskan Anda untuk mendefinisikan:

• Sebuah Owner: akun pribadi Anda atau organisasi yang Anda ikuti.

• Nama Space: nama Space di dalam akun tempat Anda membuat Space.

• Visibility: private jika Anda ingin Space hanya terlihat oleh Anda atau organisasi Anda, atau public jika Anda ingin Space terlihat oleh pengguna atau aplikasi lain yang menggunakan Label Studio API (disarankan).

🚀 Menggunakan Konfigurasi Default

Secara default, Label Studio diinstal di Spaces dengan konfigurasi yang menggunakan penyimpanan lokal untuk basis data aplikasi guna menyimpan konfigurasi, kredensial akun, dan informasi proyek. Tugas penandaan dan item data juga disimpan di penyimpanan lokal.

Penyimpanan di Hugging Face Spaces bersifat sementara secara default. Untuk mempertahankan data Anda di antara restart, hubungkan Storage Bucket — lihat bagian persistensi di bawah.

Setelah meluncurkan Label Studio, Anda akan ditampilkan layar login standar. Anda dapat memulai dengan membuat akun baru menggunakan alamat email Anda dan masuk dengan kredensial baru Anda. Secara berkala setelah masuk, Label Studio akan memperingatkan Anda bahwa penyimpanan bersifat sementara dan data dapat hilang jika Space Anda dimulai ulang. Anda juga akan diberi prompt dari Heidi, maskot Label Studio yang membantu, untuk membuat proyek baru agar dapat mulai memberi label pada data Anda. Untuk memulai, lihat tutorial Label Studio “Zero to One” yang berisi panduan tentang cara membangun antarmuka anotasi untuk analisis sentimen.

🛠️ Mengonfigurasi Instance Label Studio yang Siap Produksi

Untuk membuat Space Anda siap produksi, Anda perlu melakukan tiga perubahan konfigurasi:

• Nonaktifkan pembuatan akun baru tanpa batasan.

• Aktifkan persistensi dengan menempelkan Storage Bucket atau database eksternal.

• Secara opsional, lampirkan penyimpanan cloud untuk tugas pelabelan.

Nonaktifkan Penciptaan Akun Baru Tanpa Batasan

Konfigurasi bawaan pada Label Studio memungkinkan pembuatan akun baru tanpa batasan bagi siapa pun yang memiliki URL aplikasi Anda. Anda dapat membatasi pendaftaran dengan menambahkan rahasia konfigurasi berikut ke Pengaturan Space Anda.

• LABEL_STUDIO_DISABLE_SIGNUP_WITHOUT_LINK: Mengatur nilai ini ke true akan menonaktifkan pembuatan akun tanpa batasan.

• LABEL_STUDIO_USERNAME: Ini adalah nama pengguna akun yang akan Anda gunakan sebagai pengguna pertama di Label Studio Space Anda. Harus berupa alamat email yang valid.

• LABEL_STUDIO_PASSWORD: Kata sandi yang akan dikaitkan dengan akun pengguna pertama.

Mulai ulang Space untuk menerapkan pengaturan ini. Kemampuan untuk membuat akun baru dari layar login akan dinonaktifkan. Untuk membuat akun baru, Anda perlu mengundang pengguna baru di pengaturan Organization dalam aplikasi Label Studio.

Aktifkan Persistensi dengan HF Storage Buckets

Secara default, Space ini menyimpan semua konfigurasi proyek dan anotasi data di penyimpanan lokal dengan SQLite. Jika Space direset, semua data konfigurasi dan anotasi di dalam Space akan hilang.

Cara termudah untuk mengaktifkan persistensi adalah dengan melampirkan Storage Bucket, yang memuat penyimpanan objek persisten langsung ke dalam Space. Label Studio menulis database SQLite dan unggahan media ke dalam bucket yang dimuat, sehingga proyek dan anotasi tetap tersimpan setelah restart.

1. Buat bucket:

   Disalin

   hf buckets create <your-namespace>/label-studio-data

2. Hubungkan di Space Settings → Storage Buckets, jalur mount /data.

3. Atur dua Variabel Space:

   Disalin

   LABEL_STUDIO_BASE_DATA_DIR=/data
   STORAGE_PERSISTENCE=1

4. Factory rebuild Space.

Setel SECRET_KEY sebagai Space Secret untuk menjaga sesi pengguna tetap aktif melintasi restart. Tanpa ini, Label Studio menghasilkan kunci acak pada setiap boot dan semua pengguna akan keluar dari sesi saat restart.

Biarkan agen coding melakukannya untuk Anda

Jika Anda lebih memilih tidak mengklik melalui pengaturan Space, Anda dapat meminta agen coding dengan akses ke huggingface_hub untuk menyiapkan Space untuk Anda. Beritahu ID Space dan nama bucket Anda, dan agen tersebut dapat menjalankan ekuivalen dari:

from huggingface_hub import HfApi, Volume

api = HfApi()
space_id = "<your-namespace>/<your-space>"

# Attach the bucket at /data
api.set_space_volumes(
    space_id,
    volumes=[
        Volume(type="bucket", source="<your-namespace>/label-studio-data", mount_path="/data"),
    ],
)

# Tell Label Studio to write its SQLite DB and media into the mounted bucket
api.add_space_variable(space_id, "LABEL_STUDIO_BASE_DATA_DIR", "/data")
api.add_space_variable(space_id, "STORAGE_PERSISTENCE", "1")

# Optional: set a stable SECRET_KEY so sessions survive restarts
api.add_space_secret(space_id, "SECRET_KEY", "<random-string>")

# Factory rebuild so the new mount and variables take effect
api.restart_space(space_id, factory_reboot=True)

Lihat panduan manage-spaces untuk informasi lebih lanjut tentang pengelolaan spaces dan volume mounts melalui huggingface_hub.

Aktifkan Persistensi dengan Postgres

Untuk deployment multi-user yang lebih berat, Anda dapat mengaktifkan persistensi dengan cara menghubungkan database Postgres eksternal ke space Anda, sehingga menjamin semua pengaturan proyek dan anotasi tetap tersimpan.

Setel variabel rahasia berikut agar sesuai dengan instance Postgres yang Anda host sendiri. Kami sangat merekomendasikan untuk menyetel ini sebagai rahasia guna mencegah kebocoran informasi tentang layanan database Anda ke publik dalam definisi spaces Anda.

• DJANGO_DB: Atur ini ke default.

• POSTGRE_NAME: Atur ini ke nama database Postgres.

• POSTGRE_USER: Atur ini ke nama pengguna Postgres.

• POSTGRE_PASSWORD: Atur ini ke kata sandi untuk pengguna Postgres Anda.

• POSTGRE_HOST: Atur ini ke host tempat database Postgres Anda berjalan.

• POSTGRE_PORT: Atur ini ke port tempat database Postgres Anda berjalan.

• STORAGE_PERSISTENCE: Setel ini ke 1 untuk menghapus peringatan tentang penyimpanan sementara.

Mulai ulang Space untuk menerapkan pengaturan ini. Informasi tentang pengguna, proyek, dan anotasi akan disimpan di database, dan akan dimuat ulang oleh Label Studio jika space dimulai ulang atau direset.

Aktifkan Penyimpanan Cloud

Secara default, satu-satunya penyimpanan data yang diaktifkan untuk Space ini adalah lokal. Dalam kasus reset Space, semua data akan hilang. Untuk mengaktifkan penyimpanan permanen, Anda harus mengaktifkan cloud storage connector. Pilih cloud connector yang sesuai dan konfigurasikan secrets untuknya.

Amazon S3

• STORAGE_TYPE: Setel ini ke s3.

• STORAGE_AWS_ACCESS_KEY_ID: <YOUR_ACCESS_KEY_ID>

• STORAGE_AWS_SECRET_ACCESS_KEY: <YOUR_SECRET_ACCESS_KEY>

• STORAGE_AWS_BUCKET_NAME: <YOUR_BUCKET_NAME>

• STORAGE_AWS_REGION_NAME: <YOUR_BUCKET_REGION>

• STORAGE_AWS_FOLDER: Setel ini ke string kosong.

Google Cloud Storage

• STORAGE_TYPE: Setel ini ke gcs.

• STORAGE_GCS_BUCKET_NAME: <YOUR_BUCKET_NAME>

• STORAGE_GCS_PROJECT_ID: <YOUR_PROJECT_ID>

• STORAGE_GCS_FOLDER: Setel ini ke string kosong.

• GOOGLE_APPLICATION_CREDENTIALS: Atur ini menjadi /opt/heartex/secrets/key.json.

Azure Blob Storage

• STORAGE_TYPE: Setel ini ke azure.

• STORAGE_AZURE_ACCOUNT_NAME: <YOUR_STORAGE_ACCOUNT>

• STORAGE_AZURE_ACCOUNT_KEY: <YOUR_STORAGE_KEY>

• STORAGE_AZURE_CONTAINER_NAME: <YOUR_CONTAINER_NAME>

• STORAGE_AZURE_FOLDER: Setel ini ke string kosong.

🤗 Langkah Berikutnya, Umpan Balik, dan Dukungan

Untuk memulai dengan Label Studio, lihat tutorial “Zero to One” Label Studio, yang memandu Anda melalui proyek anotasi analisis sentimen sebagai contoh. Anda dapat menemukan kumpulan sumber daya lengkap tentang Label Studio dan komunitas Label Studio di Label Studio Home Page. Ini mencakup dokumentasi lengkap, playground interaktif untuk mencoba berbagai antarmuka anotasi, serta tautan untuk bergabung dengan Label Studio Slack Community.