Fase 0 · Setup Toolchain

uv — Installation

Langkah pemasangan uv per sistem operasi, cara memverifikasi, memperbarui, dan menghapusnya.

Sumber asli docs.astral.sh/uv Resmi Rangkuman ~4 menit baca

Intisari

Satu baris curl untuk Linux/macOS, satu baris PowerShell untuk Windows. Tidak butuh Python terpasang lebih dulu.
uv adalah satu binary mandiri (~30 MB) — tidak mengotori Python sistem.
Setelah pasang, buka terminal baru. Ini penyebab nomor satu uv: command not found.
Update dengan uv self update, bukan install ulang.
Verifikasi: uv --version lalu uv python install 3.13.

Pilih satu sesuai OS-mu

Linux & macOS

curl -LsSf https://astral.sh/uv/install.sh | sh

Script ini menaruh binary uv di ~/.local/bin dan menambahkan folder itu ke PATH lewat file profil shell-mu (~/.bashrc, ~/.zshrc, dst).

Windows

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Lewat package manager (alternatif)

brew install uv               # macOS, Homebrew
winget install --id=astral-sh.uv  # Windows
pipx install uv               # kalau kamu sudah punya pipx

Jangan pakai pip install uv. Secara teknis bisa, tapi itu membuat uv bergantung pada instalasi Python tertentu — padahal justru uv yang seharusnya mengurus Python, bukan sebaliknya. Pakai installer mandiri di atas.

Setelah pasang: buka terminal baru

Installer memodifikasi file profil shell, tapi shell yang sedang berjalan sudah terlanjur membaca profil lamanya. Tutup terminal, buka lagi. Kalau masih belum kebaca:

source ~/.bashrc          # atau ~/.zshrc, sesuai shell-mu
echo $PATH | tr ':' '\n' | grep local/bin   # pastikan ~/.local/bin ada di sini

Verifikasi

uv --version
# uv 0.9.x (abc1234 2026-01-01)

uv python install 3.13
uv python list

Kalau dua perintah terakhir berhasil, setup-mu beres. uv baru saja mengunduh interpreter Python sendiri — terpisah total dari Python bawaan sistem, jadi tidak ada risiko merusak apa pun.

Update & uninstall

uv self update            # kalau dipasang lewat installer mandiri
brew upgrade uv           # kalau dipasang lewat Homebrew

# Uninstall
uv cache clean            # hapus cache download
rm -r "$(uv python dir)"  # hapus interpreter yang di-manage uv
rm -r "$(uv tool dir)"    # hapus tool yang diinstal uv
rm ~/.local/bin/uv ~/.local/bin/uvx

Autocomplete di shell (opsional tapi enak)

# bash
echo 'eval "$(uv generate-shell-completion bash)"' >> ~/.bashrc

# zsh
echo 'eval "$(uv generate-shell-completion zsh)"' >> ~/.zshrc

Kalau kamu di balik proxy perusahaan

uv menghormati variabel lingkungan standar. Kalau download-nya macet, biasanya salah satu ini yang belum diatur:

export HTTPS_PROXY=http://proxy.perusahaan.local:8080
export UV_INDEX_URL=https://mirror-internal/simple   # kalau ada mirror PyPI internal
export SSL_CERT_FILE=/path/ke/sertifikat-perusahaan.pem

Rangkuman ini sengaja dipangkas ke bagian yang dipakai di roadmap. Buka sumber aslinya saat kamu butuh detail lengkap atau referensi parameter.