Menyiapkan uv di Ubuntu

Tujuan halaman ini #

Menginstal Python 3.13 dan uv di Ubuntu 22.04 / 24.04 LTS
Membuat, mengaktifkan, dan mengelola lingkungan virtual untuk proyek belajar
Mengenali kendala umum serta langkah pemeriksaan ketika terjadi masalah

Prasyarat #

Item	Rincian
Hak akses	Dapat menjalankan `sudo` untuk mengelola paket
Terminal	Buka dengan Ctrl + Alt + T atau dari menu aplikasi
Folder kerja	Contoh: `~/projects/my-app` (boleh diganti)

1. Instal Python 3.13 #

Repositori bawaan Ubuntu belum menyediakan Python 3.13, jadi tambahkan PPA deadsnakes.

sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update
sudo apt install -y python3.13 python3.13-venv python3.13-dev python3.13-distutils
python3.13 --version

Jika muncul Python 3.13.x, instalasi berhasil.

2. Instal uv #

curl -LsSf https://astral.sh/uv/install.sh | sh
~/.local/bin/uv --version

Jika uv belum dikenali, tambahkan ~/.local/bin ke PATH:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

3. Buat folder proyek dan lingkungan virtual #

mkdir -p ~/projects/my-app
cd ~/projects/my-app
uv venv --python 3.13 .venv
source .venv/bin/activate

Tanda (.venv) menunjukkan lingkungan aktif. Gunakan deactivate untuk keluar.

庁 Tanpa aktivasi pun kamu bisa menjalankan uv run python script.py; uv otomatis menggunakan lingkungan tadi.

4. Tambah & sinkronkan pustaka #

uv pip install numpy pandas
uv pip list
uv pip sync requirements.txt

uv pip install: menambahkan paket
uv pip list: melihat paket yang terpasang
uv pip sync: membangun ulang lingkungan sesuai requirements.txt

5. Integrasi dengan editor (VS Code, dll.) #

Di VS Code, instal ekstensi 窶弃ython窶・ tekan Ctrl+Shift+P, pilih Python: Select Interpreter, dan arahkan ke .venv/bin/python.
Jika memakai editor terminal (vim, neovim), jalankan editor dari shell yang sudah mengaktifkan lingkungan.

6. Masalah umum #

Masalah	Solusi
`add-apt-repository` tidak tersedia	Jalankan `sudo apt install software-properties-common`
`uv` belum masuk PATH	Tambahkan `~/.local/bin` ke PATH dan muat ulang shell
`Permission denied` saat membuat `.venv`	Cek kepemilikan folder (`ls -ld .`), ubah dengan `chown` bila perlu

7. Pembersihan #

Keluar dari lingkungan: deactivate
Hapus lingkungan: rm -rf .venv
Catat dependensi: uv pip freeze > requirements.txt

Ubuntu kini siap dengan Python 3.13 + uv. Bandingkan juga panduan Windows dan macOS, lalu lanjutkan ke bab sintaks untuk mulai menulis kode.

Jika semuanya sudah siap, lanjutkan ke langkah berikutnya untuk mulai belajar Python.

Langkah selanjutnya: Mulai belajar Python