Instalasi

Instal QZX di lingkungan Python yang Anda kendalikan

Gunakan pip dalam virtual environment atau pipx untuk mengisolasi CLI. Setelah instalasi, periksa versi lalu jalankan satu diagnosis hanya-baca.

Sudah diinstal, tetapi qzx tidak bisa dijalankan?

Coba QZX dalam 60 detik

Pastikan QZX berfungsi dengan timestamp ISO yang cepat dan hanya-baca.

python -m pip install --upgrade qzx
qzx getCurrentDateTime --output-format iso --json

Jalankan kedua perintah ini di terminal. JSON dengan success: true dan message yang tidak kosong menandakan pemeriksaan pertama berhasil; menyalin saja tidak menginstal atau menjalankan apa pun.

QZX — Quick Zap Exchange, dibuat dan dipelihara oleh Alejandro Sánchez.

QZX untuk Codex, Claude Code, dan Gemini CLI — Panduan Cepat

Dengan pip

Di lingkungan Python yang sesuai, instal package publik dari PyPI.

python -m pip install --upgrade qzx
qzx version

Isolasi CLI dengan pipx

pipx membuat environment khusus untuk QZX dan membuat executable tersedia melalui PATH.

pipx install qzx
qzx version

Pemeriksaan pertama yang berguna

Mulailah dengan command yang tidak mengubah sistem. Untuk agen pemrograman, diagnoseProject biasanya lebih berguna daripada membuat script pengenalan environment sementara.

qzx getCurrentDateTime

qzx diagnoseProject .

Sudah menginstal, tetapi terminal tidak menemukan qzx?

Pilih langkah pemulihan sesuai metode instalasi Anda. Tidak ditemukannya peluncur belum tentu berarti paketnya belum terpasang.

Saya memakai pip: jalankan melalui Python yang sama

Gunakan Python yang sama saat instalasi: python, python3, atau py -3.13.

python -m qzx version --json
python -m qzx getCurrentDateTime --output-format iso --json

Gunakan interpreter yang sama persis dengan yang menjalankan python -m pip install --upgrade qzx. Menjalankan sebagai modul tidak memerlukan peluncur qzx di PATH.

Jika Anda menginstal dengan python3 atau py -3.13, ganti python dengan prefiks yang sama pada semua perintah berikut. Jangan mengganti interpreter di tengah proses.

Muncul No module named qzx atau versi yang tidak diharapkan?

Periksa interpreter ini sebelum menginstal ulang. Aktifkan lingkungan tempat QZX diinstal, lalu periksa pip dan lokasi paketnya:

python -m pip --version
python -m pip show qzx

Jika pip tidak menemukan QZX di sini, paket tidak ada pada interpreter ini. Jika qzx version --json dan perintah modul menampilkan versi berbeda, keduanya mengarah ke instalasi yang berbeda. Perbarui hanya instalasi yang ingin Anda gunakan. Kesalahan externally-managed-environment tetap memerlukan lingkungan yang Anda kendalikan atau pipx, bukan pemaksaan pada Python yang dikelola sistem.

Saya memakai pipx: pulihkan peluncurnya

Jalankan pipx list terlebih dahulu. Jika QZX terdaftar, jalankan pipx ensurepath dan ikuti petunjuk untuk membuka ulang atau menyegarkan terminal, lalu coba qzx version --json. Jika QZX tidak terdaftar, gunakan opsi instalasi pipx di atas.

Python sistem biasanya tidak dapat mengimpor paket yang diisolasi pipx: python -m qzx bukan langkah perbaikan pipx. pipx run menguji lingkungan sementara, bukan instalasi yang sudah ada.

Setelah verifikasi berhasil, buka folder proyek Anda sendiri dan coba python -m qzx diagnoseProject . melalui interpreter yang digunakan pip, atau qzx diagnoseProject . melalui peluncur pipx. QZX memeriksa proyek; tidak menjalankan pengujian atau skrip build proyek tersebut.

Masih bermasalah? Dapatkan bantuan instalasi

Sebelum membagikan diagnosis, hapus jalur pribadi, kredensial, dan detail proyek privat.