ติดตั้ง Qiskit SDK และ Qiskit Runtime จากซอร์ส

การติดตั้ง Qiskit SDK จากซอร์สช่วยให้เข้าถึงเวอร์ชัน development ปัจจุบันได้ แทนที่จะใช้เวอร์ชันจาก Python Package Index (PyPI) ซึ่งทำให้สามารถตรวจสอบและขยายโค้ด Qiskit เวอร์ชันล่าสุดได้อย่างมีประสิทธิภาพมากขึ้น

สร้างและเปิดใช้งาน virtual environment ใหม่

1. ไปยัง project directory และสร้าง environment เบื้องต้นที่มีแค่ Python ติดตั้งอยู่

   macOS

   python3 -m venv .venv

   Linux

   python3 -m venv .venv

   Windows

   python -m venv .venv

2. เปิดใช้งาน environment ใหม่

   macOS

   source .venv/bin/activate

   Linux

   source .venv/bin/activate

   Windows

   .venv\Scripts\Activate.ps1

ติดตั้ง Rust compiler

ต้องติดตั้ง Rust compiler บนระบบเพื่อ compile Qiskit ใช้ rustup ซึ่งเป็น Rust installer ข้ามแพลตฟอร์ม หรือ วิธีติดตั้งอื่น

ติดตั้ง Qiskit

ทำตามขั้นตอนเหล่านี้เพื่อติดตั้ง Qiskit:

1. Clone Qiskit repository

git clone https://github.com/Qiskit/qiskit.git

2. เข้าไปยัง directory qiskit

cd qiskit

3. (ไม่บังคับ) ถ้าต้องการรัน tests หรือ linting checks ให้ติดตั้ง developer requirements

pip install -r requirements-dev.txt

4. ติดตั้ง qiskit

• Standard install:

  pip install .

• Editable mode: ในโหมดนี้ไม่จำเป็นต้องติดตั้ง Qiskit ใหม่เมื่อมีการเปลี่ยนแปลงโค้ดในโปรเจกต์

  pip install -e .

  ใน editable mode extension ที่ compile แล้วจะถูก build ใน debug mode โดยไม่มีการ optimize ซึ่งส่งผลต่อ runtime performance ของโค้ดที่ compile แล้ว เพื่อ build extension เหล่านั้นพร้อมการ optimize ให้รันคำสั่งต่อไปนี้เพื่อ rebuild binary ใน release mode:

  python setup.py build_rust --release --inplace

  หมายเหตุ

  ถ้ากำลังทำงานกับโค้ด Rust ใน Qiskit จะต้อง rebuild extension code ทุกครั้งที่แก้ไขโค้ดใน local ใน editable mode Rust extension จะถูก build เฉพาะตอนรันคำสั่งติดตั้งเท่านั้น ดังนั้นการเปลี่ยนแปลงโค้ด Rust ใน local จะไม่สะท้อนใน package ที่ติดตั้งจนกว่าจะ rebuild extension โดยรัน build_rust ใหม่อีกครั้ง (ใช้หรือไม่ใช้ --release ขึ้นอยู่กับว่าต้องการ build ใน release หรือ debug mode)

ติดตั้ง Qiskit Runtime

ทำตามขั้นตอนเหล่านี้ถ้าต้องการติดตั้ง Qiskit Runtime:

1. Clone Qiskit Runtime repository

git clone https://github.com/Qiskit/qiskit-ibm-runtime.git

2. เข้าไปยัง directory qiskit-ibm-runtime

cd qiskit-ibm-runtime

3. ติดตั้ง qiskit-runtime แนะนำให้ใช้ virtual environment เพื่อหลีกเลี่ยงการรบกวน Python installation หลักของระบบ

• Standard install:

  pip install .

• Editable mode: ในโหมดนี้ไม่จำเป็นต้องติดตั้ง Qiskit ใหม่เมื่อมีการเปลี่ยนแปลงโค้ดในโปรเจกต์

  pip install -e .

  ใน editable mode extension ที่ compile แล้วจะถูก build ใน debug mode โดยไม่มีการ optimize

4. (ไม่บังคับ) ถ้าต้องการรัน tests หรือ linting checks ให้ติดตั้ง developer requirements แนะนำให้ใช้ virtual environment เพื่อหลีกเลี่ยงการรบกวน Python installation หลักของระบบ

pip install -e ".[dev]"

ขั้นตอนถัดไป

Recommendations

• อ่าน contributing guidelines เพื่อมีส่วนร่วมกับ Qiskit SDK แบบ open-source
• รัน Hello world program
• ลอง tutorial เช่น Grover's algorithm