#
Pendahuluan

Selamat datang di kursus Hugging Face! Pada bab ini, Anda akan dipandu untuk menyiapkan working environment. Jika ini adalah pertama kalinya Anda mengikuti kursus ini, sangat disarankan untuk menyelesaikan Bab 1 terlebih dahulu. Setelah menyelesaikan Bab 1, Anda dapat kembali ke halaman ini untuk mulai mengeksplorasi kode secara mandiri.

Semua modul yang digunakan dalam kursus ini tersedia sebagai modul Python. Anda juga akan dipandu untuk menyiapkan lingkungan Python dan menginstal modul-modul yang dibutuhkan.

Ada dua opsi working environment yang dapat Anda gunakan: Colab notebook atau virtual environment Python. Anda bebas memilih yang sesuai, tetapi bagi pemula, kami menyarankan untuk menggunakan Colab notebook.

Catatan: kursus ini tidak mencakup panduan instalasi untuk pengguna Windows. Jika Anda menggunakan Windows, mohon gunakan Colab notebook. Bagi pengguna Linux atau macOS, Anda bebas memilih working environment yang akan dijelaskan di bawah.

Sebagian besar bagian dalam kursus ini akan membutuhkan akun Hugging Face. Jika Anda belum memiliki akun, silakan daftar terlebih dahulu melalui tautan berikut: https://huggingface.co/join.

##
Menggunakan Google Colab Notebook

Menggunakan Colab notebook sangatlah mudah — cukup buat notebook baru dan Anda sudah bisa mulai menulis kode!

Jika Anda belum familiar dengan Colab, silakan lihat tutorial pengenalan Colab dari Google (tersedia dalam Bahasa Inggris). Dengan Colab, Anda juga dapat mengakses hardware seperti GPU dan TPU secara gratis, yang dapat mempercepat proses pemrosesan data untuk proyek berskala kecil.

Setelah terbiasa, buatlah notebook baru dan ikuti pengaturan awal berikut:

Langkah selanjutnya adalah menginstal modul yang dibutuhkan menggunakan `pip`, yaitu manajer paket untuk Python. Di dalam notebook, Anda bisa menjalankan perintah sistem dengan menambahkan tanda seru (`!`) sebelum instruksinya. Contoh perintah instalasi 🤗 Transformers:

    !pip install transformers

Untuk memastikan modul telah terinstal dengan benar, coba lakukan import modul tersebut di dalam runtime Python Anda:

    import transformers

Perintah di atas menginstal versi ringan dari 🤗 Transformers, tanpa pustaka machine learning seperti PyTorch atau TensorFlow. Karena dalam kursus ini Anda akan menggunakan berbagai fitur tambahan, sangat disarankan untuk menginstal versi development yang lebih lengkap dengan perintah berikut:

    !pip install transformers[sentencepiece]

Proses instalasi mungkin akan memakan waktu beberapa menit. Setelah selesai, Anda siap melanjutkan kursus ini!

##
Menggunakan Python Virtual Environment

Jika Anda memilih untuk menggunakan virtual environment, langkah pertama adalah menginstal Python. Panduan instalasi dapat ditemukan di tautan berikut: https://realpython.com/installing-python/.

Setelah Python berhasil diinstal, jalankan perintah berikut di terminal untuk memastikan bahwa Python telah terpasang dengan benar:

    python --version

Perintah tersebut akan menampilkan versi Python yang digunakan sistem Anda. Python bawaan sistem disebut sebagai versi utama, dan sebaiknya tidak diubah. Untuk setiap proyek pengembangan, disarankan menggunakan versi Python terpisah, karena setiap proyek umumnya memerlukan dependensi yang berbeda. Hal ini bertujuan untuk menghindari konflik antar modul.

Solusi terbaik adalah dengan menggunakan virtual environment, yaitu instalasi Python terisolasi yang hanya digunakan untuk satu proyek tertentu. Dalam kursus ini, kita akan menggunakan modul bawaan Python, yaitu `venv`, untuk membuatnya.

Pertama, buat folder baru untuk menyimpan proyek Anda. Misalnya:

    mkdir ~/transformers-course
    cd ~/transformers-course

Kemudian buat virtual environment:

    python -m venv .env

Setelah dijalankan, akan muncul folder baru bernama `.env`:

    ls -a

    .      ..    .env

Berikut ini perintah untuk mengaktifkan dan menonaktifkan virtual environment:

    # Mengaktifkan virtual environment
    source .env/bin/activate

    # Menonaktifkan virtual environment
    deactivate

Untuk memastikan Anda menggunakan versi Python dari virtual environment, jalankan:

    which python

Jika hasilnya menunjuk ke folder `.env`, maka virtual environment Anda sudah aktif:

    /home/<user>/transformers-course/.env/bin/python

###
Instalasi Modul

Sama seperti di Google Colab, Anda perlu menginstal pustaka yang dibutuhkan. Gunakan perintah berikut untuk menginstal versi development dari 🤗 Transformers:

    pip install "transformers[sentencepiece]"

Sekarang Anda siap untuk mulai belajar!

< > Update on GitHub