pip di Python: install package, kelola versi, dan pakai PyPI

Apa sebenarnya pip itu

pip adalah alat untuk meng-install library Python yang tidak kamu tulis sendiri. Saat kamu menjalankan pip install requests, pip mencari requests di PyPI (Python Package Index), mengunduh versi yang tepat untuk platformmu, lalu menaruhnya di direktori site-packages instalasi Python-mu. Setelah itu, import requests bisa dipakai.

Setiap instalasi Python 3 dari python.org, Homebrew, atau package manager Linux-mu sudah membawa pip. Sebelum meng-install apa pun, periksa dulu:

python -m pip --version

Kamu seharusnya melihat nomor versi dan path ke module pip. Kalau perintahnya gagal, perbaikan yang paling bisa diandalkan adalah:

python -m ensurepip --upgrade

Perintah itu memasang pip ke instalasi Python-mu memakai salinan yang ikut bersama interpreter.

python -m pip vs pip

Kamu akan melihat kedua bentuk ini. Keduanya melakukan hal yang hampir sama, dengan satu perbedaan penting: python -m pip memakai python yang ada di PATH-mu, yaitu yang sama dengan yang dipakai skripmu. pip saja memakai pip mana pun yang kebetulan ditemukan lebih dulu, dan itu tidak selalu sama.

Saat kamu punya lebih dari satu Python ter-install (mudah terjadi di macOS), pip saja adalah penyebab situasi membingungkan "aku sudah meng-install library-nya, tapi kodeku masih bilang ModuleNotFoundError".

Aturan praktis: pakai python -m pip ... kalau kamu ingin yakin interpreter mana yang mendapat package-nya. pip saja tidak masalah untuk pekerjaan cepat kalau kamu sudah yakin.

Meng-install package

Perintah dasarnya:

python -m pip install requests

Perintah itu mengambil requests dari PyPI, beserta semua dependensinya, lalu meng-install semuanya. Semenit kemudian kamu sudah bisa memakainya:

# This runs in your browser - the Coddy runtime ships with requests.
import requests

response = requests.get("https://httpbin.org/json")
print(response.status_code)
print(response.json())

Meng-install beberapa package sekaligus:

python -m pip install requests pandas rich

Mengunci versi tertentu:

python -m pip install "django==5.0.2"
python -m pip install "requests>=2.30,<3"

Tanda kutipnya penting di sebagian shell: tanda kutip mencegah == dan < ditafsirkan sebagai operator shell.

Upgrade dan uninstall

python -m pip install --upgrade requests
python -m pip uninstall requests

--upgrade mengambil versi terbaru yang memenuhi batasan apa pun yang kamu tentukan. uninstall menghapus package-nya, tapi tidak dependensinya; dependensi itu tetap ada sampai kamu menghapusnya secara eksplisit.

Supaya pip sendiri tetap terbaru:

python -m pip install --upgrade pip

Layak dijalankan sekali setiap beberapa bulan. Versi pip yang lebih baru menangkap lebih banyak masalah instalasi dan menyelesaikan dependensi dengan lebih baik.

Melihat apa saja yang ter-install

python -m pip list
python -m pip show requests

list menampilkan setiap package yang ter-install di Python saat ini. show requests mencetak versi, lokasi, dependensi, dan lisensi package tersebut. Berguna saat kamu bertanya-tanya "versi mana sebenarnya yang sedang aku pakai?"

requirements.txt: mencatat dependensimu

Saat sebuah proyek punya lebih dari beberapa library, catat daftarnya. pip freeze melakukannya untukmu:

python -m pip freeze > requirements.txt

Hasilnya sebuah file dengan satu dependensi yang dikunci per baris:

django==5.0.2
requests==2.31.0
rich==13.7.1

Siapa pun yang meng-clone repo-mu bisa mengulang instalasinya dengan:

python -m pip install -r requirements.txt

pip freeze mencatat semua yang ter-install, termasuk dependensi tidak langsung. Itu bagus untuk hasil yang persis sama, tapi terlalu ramai kalau kamu hanya ingin library tingkat atas yang benar-benar di-import kodemu. Banyak proyek menyimpan requirements.txt berisi dependensi langsung yang diurus manual, lalu membiarkan pip menyelesaikan dependensi tidak langsungnya.

Untuk proyek modern, pyproject.toml (dipadukan dengan alat seperti pip-tools, uv, poetry, atau hatch) mulai menggantikan requirements.txt. Konsepnya sama, "catat dependensinya, jalankan satu perintah untuk meng-install-nya", tapi format file-nya lebih terstruktur.

Selalu install ke dalam virtual environment

Setiap proyek Python sungguhan sebaiknya punya virtual environment. Virtual environment adalah folder lokal proyek dengan python sendiri dan package ter-install sendiri, sehingga pip install di satu proyek tidak memengaruhi proyek lain.

Penyiapan dua baris:

python -m venv .venv
source .venv/bin/activate    # macOS / Linux
# or .venv\Scripts\activate on Windows

Setelah aktif, python -m pip install requests meng-install ke dalam venv. Python sistemmu tetap bersih. Kami membahas ini lebih dalam di halaman Virtual Environment.

Kalau suatu saat kamu menjalankan pip install dan melihat peringatan tentang instalasi ke Python sistem (atau pesan yang menyuruhmu menambahkan --break-system-packages), berhenti. Itu tanda untuk membuat venv saja.

Saat pip tidak bisa meng-install package

Beberapa kegagalan umum dan artinya:

• Could not find a version that satisfies the requirement …: biasanya salah ketik di nama package, atau package-nya butuh Python yang lebih baru daripada milikmu.
• error: Microsoft Visual C++ 14.0 or greater is required (Windows): package-nya punya ekstensi native dan butuh toolchain build C++. Install Build Tools dari Microsoft, atau cari wheel yang sudah jadi (kebanyakan package populer menyediakannya).
• Permission denied: kamu mencoba meng-install ke Python sistem tanpa akses root. Solusi yang benar bukan sudo pip install, melainkan virtual environment.
• ModuleNotFoundError setelah instalasi: hampir selalu karena pip install menaruh package-nya di Python yang berbeda dengan yang menjalankan skripmu. Periksa which python dan which pip (macOS/Linux) atau where python / where pip (Windows). Atau, yang lebih bisa diandalkan, pakai python -m pip install ....

Alternatif modern untuk pip

Beberapa alat yang akan kamu dengar. Semuanya kompatibel dengan pip dan menyelesaikan masalah tertentu:

• uv: installer dan resolver yang jauh lebih cepat. Bisa langsung menggantikan kebanyakan perintah pip.
• pipx: meng-install alat command line (seperti black, ruff, httpie) di venv terisolasi, sehingga alat itu tersedia secara global tanpa bentrok dengan dependensi proyek.
• poetry dan hatch: pengelola proyek yang menggabungkan penanganan virtual environment, penyelesaian dependensi, dan proses build dalam satu alat.

Kamu tidak butuh satu pun di hari pertama. Pelajari pip dulu; pakai alat lain saat masalah yang mereka selesaikan mulai kamu alami sendiri.

Berikutnya: virtual environment

Package dan virtual environment berjalan beriringan. Kamu sudah melihat alasannya; halaman berikutnya membahas venv secara rinci: membuat, mengaktifkan, menonaktifkan, dan konvensi kecil yang menjaga proyek Python tetap rapi.