Mengalami masalah saat menginstal paket Python menggunakan alat “pip” di Raspberry Pi OS Bookworm? Ada beberapa langkah tambahan yang perlu Anda ambil, melibatkan pembuatan lingkungan virtual Python. Berikut cara melakukannya.
Apa yang Berubah di Raspberry Pi OS Bookworm?
Karena Raspberry Pi 5 tidak kompatibel dengan versi sebelumnya dari Raspberry Pi OS, Anda perlu menginstal versi “Bookworm” yang baru di dalamnya. Ini adalah salah satu hal yang perlu dipertimbangkan ketika beralih ke Raspberry Pi 5 dari model sebelumnya.
Pada versi sebelumnya dari sistem operasi Raspberry Pi OS berbasis Debian (Buster dan sebelumnya), mungkin untuk menginstal perpustakaan Python secara langsung, secara sistem, menggunakan alat manajemen paket pip. Namun, hal ini tidak berlaku lagi di Raspberry Pi OS Bookworm yang baru.
Seperti yang dijelaskan dalam dokumentasi Raspberry Pi, masalahnya adalah penggunaan alat khusus Python seperti pip dapat menyebabkan konflik dengan manajer paket OS apt.
Oleh karena itu, mulai dari Bookworm, ketika menggunakan pip, paket harus diinstal ke dalam lingkungan virtual Python yang terisolasi, yang memastikan bahwa mereka tidak dapat mengganggu versi sistem Python.
Jika Anda mencoba menggunakan perintah pip install [nama paket] di tempat lain dalam sistem, Anda akan menerima kesalahan yang dimulai dengan teks ini:
error: externally-managed-environment
× This environment is externally managed
╰─> To install Python packages system-wide, try apt install
python3-xyz, where xyz is the package you are trying to
install.
Ada beberapa alternatif untuk menginstall package/library python di Raspberry Pi OS Bookworm ini.
1. Dengan aplikasi apt-get
2. Install dengan python virtual environment (venv)
3. Install dengan PIP
Install Package Python dengan apt-get
Langkah pertama yang perlu diperiksa adalah apakah paket Python yang Anda butuhkan tersedia untuk diinstal menggunakan manajer paket apt secara sistem. Anda dapat mencari paket dalam repositori resmi dengan menggunakan perintah apt search. Sebagai contoh:
apt search numpy
Catat nama paketnya, dalam hal ini python3-numpy (untuk Python versi 3), dan kemudian instal dengan apt (diberi awalan sudo untuk hak istimewa superuser yang diperlukan untuk instalasi):
sudo apt install python3-numpy
Jika paket Python yang Anda butuhkan tidak tersedia menggunakan manajer paket apt, atau jika Anda memerlukan versi yang lebih baru, Anda perlu menggunakan alat khusus Python, yaitu pip, untuk menginstalnya—di dalam lingkungan virtual Python.
Install Package Python dengan Virtual Environment (venv)
Untuk menginstal paket Python dengan alat pip di Raspberry Pi OS Bookworm, Anda pertama harus membuat lingkungan virtual Python menggunakan venv. Kami menyebutnya “muo-project”, tetapi Anda dapat menggunakan nama apa pun yang Anda inginkan:
python -m venv muo-project
Ini akan memakan waktu beberapa saat untuk menyelesaikannya, tergantung pada model Raspberry Pi yang Anda gunakan. Kemudian, Anda perlu mengubah direktori ke folder lingkungan yang baru dibuat, yang berisi distribusi Python lengkap, dan mengaktifkannya:
cd muo-project
source bin/activate
Lingkungan virtual Python sekarang siap digunakan, dan prompt sistem akan diberi awalan dengan namanya—dalam hal ini, muo-project. Hal ini menunjukkan bahwa Anda tidak lagi menggunakan versi Python sistem, melainkan yang berada di dalam lingkungan virtual Anda. Jadi, setiap perubahan yang Anda buat atau modul yang Anda instal tidak akan memengaruhi Python sistem.
Install Package Python dengan PIP
Dari dalam lingkungan virtual Python yang aktif, Anda sekarang dapat menginstal paket apa pun yang Anda butuhkan menggunakan perintah pip. Sebagai contoh, untuk menginstal alat pengujian ketegangan sistem Stressberry:
pip install stressberry
Ini akan menginstal modul tersebut, beserta dependensinya, di dalam lingkungan virtual Python Anda. Perlu diingat bahwa modul tersebut hanya akan tersedia di dalamnya dan tidak secara sistemik.