Antarmuka manajemen sumber daya kuantum (QRMI)

Antarmuka manajemen sumber daya kuantum (QRMI) adalah library yang tidak bergantung pada vendor, dirancang untuk sistem komputasi berkinerja tinggi (HPC) agar bisa mengakses, mengontrol, dan memantau perilaku sumber daya komputasi kuantum. Library ini berfungsi sebagai lapisan middleware tipis yang menyembunyikan kompleksitas pengendalian sumber daya kuantum melalui sekumpulan API sederhana. Ditulis dalam Rust, antarmuka ini juga mengekspos API Python dan C agar mudah diintegrasikan ke hampir semua lingkungan komputasi.

Temukan kode sumber untuk membangun dan mendeploy QRMI di repositori GitHub ini.

Tool baris perintah opsional task_runner untuk mengeksekusi payload kuantum terhadap hardware kuantum disertakan dalam paket Python. Temukan dokumentasi lengkapnya di repositori GitHub.

Membangun library QRMI

Bagian ini menjelaskan cara membangun QRMI untuk C dan Python.

Persyaratan

QRMI mendukung sistem operasi (OS) berikut:

AlmaLinux 9, Amazon Linux 2023, CentOS Stream 9, CentOS Stream 10,
RedHat Enterprise Linux 8, RedHat Enterprise Linux 9,
RedHat Enterprise Linux 10, Rocky Linux 8, Rocky Linux 9, SuSE 15,
Ubuntu 22.04, Ubuntu 24.04, MacOS Sequoia 15.1 or above

Lingkungan kompilasi

• Rust compiler versi 1.91 atau lebih baru
• Compiler C: misalnya, GCC (gcc) di Linux dan Clang (clang-tools-extra) untuk target Rust yang tidak dikenal/kompilasi silang. QRMI kompatibel dengan compiler yang sesuai standar C11
• make/cmake (make/cmake RPM untuk OS kompatibel RHEL)
• openssl (openssl-devel RPM untuk OS kompatibel RHEL)
• zlib (zlib-devel RPM untuk OS kompatibel RHEL)
• Python 3.11, 3.12, atau 3.13 (untuk API Python)
  • Library dan file header yang diperlukan untuk pengembangan Python (python3.1x-devel RPM untuk OS kompatibel RHEL):
    • /usr/include/python3.1x
    • /usr/lib64/libpython3.1x.so
• Doxygen (untuk menghasilkan dokumentasi C API), tergantung OS:
  • dnf install doxygen untuk Linux (RHEL/CentOS/Rocky Linux dan lainnya)
  • apt install doxygen untuk Linux (Ubuntu dan lainnya)
  • brew install doxygenuntuk MacOS

Lingkungan runtime

• gcc (libgcc RPM untuk OS kompatibel RHEL)
• openssl (openssl-libs RPM untuk OS kompatibel RHEL)
• zlib (zlib RPM untuk OS kompatibel RHEL)
• Python 3.11, 3.12, atau 3.13 (untuk API Python)
  • Library dan file header yang diperlukan untuk pengembangan Python (python3.1x-devel RPM untuk OS kompatibel RHEL)

---

Bangun library Rust/C API dengan perintah berikut di lokasi tempat kamu menyimpan repositori QRMI.

. ~/.cargo/env
cargo clean
cargo build --release

Untuk membangun paket Python, pertama siapkan lingkungan Python dan install dependensi yang diperlukan.

. ~/.cargo/env
cargo clean
python3.12 -m venv ~/py312_qrmi_venv
source ~/py312_qrmi_venv/bin/activate
pip install --upgrade pip
pip install -r requirements-dev.txt

Buat file stub untuk kode Python.

. ~/.cargo/env
cargo run --bin stubgen --features=pyo3

Terakhir, bangun wheel Python untuk didistribusikan ke host-mu.

source ~/py312_qrmi_venv/bin/activate
CARGO_TARGET_DIR=./target/release/maturin maturin build --release

Wheel dibuat di direktori ./target/release/maturin/wheels. Kamu bisa mendistribusikan dan menginstallnya di host-mu dengan pip install <wheel>.

Logging

QRMI mendukung log crate untuk logging. Kamu bisa menemukan log runtime QRMI yang detail dengan menentukan variabel lingkungan RUST_LOG beserta level log-nya. Level yang didukung adalah error, warn, info, debug, dan trace. Level default-nya adalah warn.

Jika kamu menentukan trace, kamu bisa menemukan log transaksi HTTP yang mendasarinya.

RUST_LOG=trace <your QRMI executable>

Contoh log:

[2025-08-16T03:47:38Z DEBUG request::connect] starting new connection: https://iam.cloud.ibm.com/
[2025-08-16T03:47:38Z DEBUG direct_access_api::middleware::auth] current token ...

Membangun dokumentasi API

Dokumentasi Rust API bisa dibuat dengan menjalankan

. ~/.cargo/env
cargo doc --no-deps --open

Dokumentasi C API bisa dibuat menggunakan doxygen:

doxygen Doxyfile

Ini akan membuat dokumen HTML di direktori ./html, yang bisa kamu buka di web browser.

Dokumentasi Python API dibuat dengan pydoc. Setelah masuk ke virtual environment dengan QRMI yang sudah terinstall, jalankan perintah berikut:

python -m pydoc -p 8290
Server ready at http://localhost:8290/
Server commands: [b]rowser, [q]uit
server> b

Lalu, buka halaman berikut di browser-mu:

http://localhost:8290/qrmi.html

Hentikan server dengan:

server> q