Перейти до основного вмісту

Встановлення Qiskit

Незалежно від того, чи будеш ти працювати локально або в хмарному середовищі, першим кроком для всіх користувачів є встановлення Qiskit.

Оновлення з Qiskit 0.x до Qiskit 1.0 і вище

(Якщо ти встановлюєш Qiskit вперше, перейди до розділу Встановлення та налаштування. Це повідомлення стосується лише користувачів, які раніше встановлювали Qiskit.)

Для тих, хто оновлюється з версії 0.x до 1.0 або пізнішої: зверніть увагу, що оскільки Qiskit v1.0 використовує нову структуру пакетів, ти не можеш використовувати pip install -U qiskit для оновлення з будь-якої версії Qiskit 0.x до 1.0.

Докладніше та інструкції дивіться у посібнику з міграції на Qiskit 1.0.

Майбутні оновлення, починаючи з Qiskit 1.0, дозволятимуть оновлення на місці.

Встановлення Qiskit SDK та клієнта Qiskit Runtime​

  1. Встановіть Python. Перевірте розділ "Programming Language" на сторінці проєкту Qiskit PyPI, щоб визначити, які версії Python підтримуються останнім випуском. Інструкції зі завантаження дивіться в Посібнику для початківців Python.

    Рекомендується використовувати віртуальні середовища Python для відокремлення Qiskit від інших додатків.

    примітка

    Ці інструкції використовують стандартний дистрибутив Python з pypi.org. Однак ти можеш використовувати інші дистрибутиви Python, такі як Anaconda або miniconda, а також інші робочі процеси управління залежностями, як-от Poetry.

    Якщо ти новачок у віртуальних середовищах, натисни тут для отримання додаткової інформації.

    Віртуальне середовище Python — це ізольований простір для роботи з Python для конкретної мети — тож ти можеш встановлювати будь-які пакети, налаштовувати бібліотеки, залежності тощо, не впливаючи на "базове" середовище Python на твоїй машині.

    Одна важлива перевага віртуального середовища полягає в тому, що якщо твоє середовище Python десь пошкодиться, ти можеш легко видалити віртуальне середовище та почати знову!

    Вибери бажане місце для зберігання інформації про твої віртуальні середовища. Зазвичай вони зберігаються в каталозі з назвою .venv у кожному каталозі проєкту, над яким ти працюєш.

    Спочатку перейди до каталогу твого проєкту та створи мінімальне середовище лише з встановленим Python.

    python3 -m venv .venv

    Далі активуй своє нове середовище.

    source .venv/bin/activate

  2. Встанови pip, якщо він ще не встановлений у твоєму середовищі. Pip — це менеджер пакетів Python, який ти використовуєш для встановлення Qiskit та інших пакетів Python. Використовуй pip list, щоб побачити, що знаходиться у твоєму віртуальному середовищі. У більшості середовищ Python pip вже встановлено.

  3. Встанови Qiskit SDK. Якщо ти плануєш виконувати завдання на квантовому обладнанні, також встанови Qiskit Runtime.

    pip install qiskit
    pip install qiskit-ibm-runtime
    Додайте підтримку візуалізації

    Якщо ти маєш намір використовувати функціонал візуалізації або Jupyter notebooks, також встанови модуль qiskit.visualization. Докладніше дивіться у довідці API візуалізацій.

  1. Якщо ти хочеш запустити Jupyter notebook з пакетами Qiskit, які ти щойно встановив, тобі потрібно встановити Jupyter у твоєму середовищі.

    pip install jupyter

    Потім відкрийте свій notebook наступним чином:

    jupyter notebook <path/to/notebook.ipynb>

Якщо ти плануєш працювати локально та використовувати симулятори, вбудовані в Qiskit, то твоє встановлення завершено. Якщо ти хочеш виконувати завдання на QPU IBM, перейди до налаштування облікового запису IBM Cloud.

Будьте в курсі останніх версій

Періодично перевіряй примітки до випуску Qiskit та примітки до випуску Qiskit Runtime, щоб побачити нові випуски. Ми рекомендуємо часто оновлювати твої вимоги для qiskit та qiskit-ibm-runtime, наприклад, змінюючи версії в requirements.txt на останні версії, а потім запускаючи pip install -r requirements.txt або відповідну команду для твого робочого процесу управління залежностями.

Потрібна допомога? Спробуйте запитати Qiskit Code Assistant.

Виправлення проблем​

Помилка "No Module 'qiskit'" з Jupyter Notebook

Якщо ти використовував pip install qiskit і налаштував своє віртуальне середовище в Anaconda, то ти можеш отримати помилку No Module 'qiskit', коли запускаєш підручник в Jupyter Notebook. Якщо ти не встановив Qiskit або не налаштував своє віртуальне середовище, ти можеш виконати кроки встановлення.

Помилка виникає при спробі імпортувати пакет Qiskit в середовищі, де Qiskit не встановлено. Якщо ти запустив Jupyter Notebook з Anaconda-Navigator, можливо, що Jupyter Notebook працює в базовому (root) середовищі, а не у твоєму віртуальному середовищі. Вибери віртуальне середовище в Anaconda-Navigator з випадаючого меню Applications on. У цьому меню ти можеш побачити всі віртуальні середовища в Anaconda, і ти можеш вибрати середовище, де у тебе встановлено Qiskit, щоб запустити Jupyter Notebook.

Помилки компіляції під час встановлення

Qiskit залежить від низки інших пакетів Python з відкритим кодом, які автоматично встановлюються при виконанні pip install qiskit. Залежно від платформи твоєї системи та версії Python, можливо, що певний пакет не надає попередньо зібраних бінарних файлів для твоєї системи. Ти можеш звернутися до Підтримка операційних систем для списку платформ, що підтримуються Qiskit, деякі з яких можуть потребувати додатковий компілятор. У випадках, коли немає доступних попередньо скомпільованих бінарних файлів, pip спробує скомпілювати пакет з джерельного коду, що, у свою чергу, може вимагати деяких додаткових залежностей, які потрібно встановити вручну.

Якщо вивід pip install qiskit містить подібні рядки до:

Failed building wheel for SOME_PACKAGE
...
build/temp.linux-x86_64-3.5/_openssl.c:498:30: fatal error
compilation terminated.
error: command 'x86_64-linux-gnu-gcc' failed with exit status 1

будь ласка, перевірте документацію пакета, який не вдалося встановити (у прикладі коду, SOME_PACKAGE) для інформації про те, як встановити бібліотеки, необхідні для компіляції з джерельного коду.

Підтримка операційних систем​

Qiskit прагне підтримувати якомога більше операційних систем, але через обмеження у доступних ресурсах тестування та доступності операційних систем не всі операційні системи можуть підтримуватися. Підтримка операційних систем для Qiskit поділяється на три рівні з різними рівнями підтримки для кожного рівня. Для платформ поза цими, таких як FreeBSD або WebAssembly (WASI), Qiskit все ще може бути встановлений, але він не тестується, і тобі доведеться зібрати Qiskit (і, ймовірно, залежності Qiskit) з джерельного коду.

Крім того, Qiskit підтримує лише реалізацію CPython мови Python. Запуск з іншими інтерпретаторами Python, такими як PyPy, не підтримується.

Qiskit v2.x​

У серії випусків Qiskit v2.x підтримуються платформи:

Рівень 1

Операційні системи рівня 1 повністю тестуються як частина процесів розробки, щоб гарантувати, що будь-яка запропонована зміна буде функціонувати коректно. Попередньо скомпільовані бінарні файли створюються, тестуються та публікуються на PyPI як частина процесу випуску. Зазвичай, за умови наявності функціонуючого середовища Python, Qiskit можна встановити на цих операційних системах без необхідності встановлення додаткових залежностей.

Операційні системи рівня 1:

  • Linux x86_64 (дистрибутиви, сумісні зі специфікацією пакування manylinux 2014).
  • macOS ARM64 (11.0 або новіша)
  • Windows 64-bit (підтримується Windows 10 і пізніші)
  • Linux AArch64 (дистрибутиви, сумісні зі специфікацією пакування manylinux 2014)

Рівень 2

Операційні системи рівня 2 не тестуються як частина процесу розробки. Однак попередньо скомпільовані бінарні файли створюються, тестуються та публікуються на PyPI як частина процесу випуску, і ці пакети можна очікувати встановити лише з функціонуючим середовищем Python. Може бути затримка у випуску пакетів для цих систем, оскільки помилки тестування можуть бути виявлені лише пізніше, і помилки під час публікації не блокуватимуть публікацію пакета для систем рівня 1.

Операційні системи рівня 2:

  • macOS x86_64 (10.12 або пізніша)

Рівень 3

Операційні системи рівня 3 не тестуються як частина процесу розробки. Попередньо скомпільовані бінарні файли створюються та публікуються на PyPI як частина процесу випуску, але не тестуються. Вони можуть не встановлюватися лише з функціонуючим середовищем Python і можуть вимагати компілятор C/C++ або додаткові програми для збирання залежностей з джерельного коду як частина процесу встановлення. Підтримка цих операційних систем надається за принципом максимальних зусиль.

Операційні системи рівня 3:

  • Linux ppc64le (дистрибутиви, сумісні зі специфікацією пакування manylinux 2014)
  • Linux s390x (дистрибутиви, сумісні зі специфікацією пакування manylinux 2014)

Починаючи з Qiskit v2.0.0, підтримуються лише 64-бітні платформи, а 32-бітні платформи не підтримуються. Ти також не зможеш зібрати з джерельного коду на 32-бітних платформах, оскільки внутрішньо код Rust у Qiskit припускає 64-бітну ширину вказівника.

Qiskit v1.x​

У серії випусків Qiskit v1.x підтримуються платформи:

Рівень 1

Операційні системи рівня 1 повністю тестуються як частина процесів розробки, щоб гарантувати, що будь-яка запропонована зміна буде функціонувати коректно. Попередньо скомпільовані бінарні файли створюються, тестуються та публікуються на PyPI як частина процесу випуску. Зазвичай, за умови наявності функціонуючого середовища Python, Qiskit можна встановити на цих операційних системах без необхідності встановлення додаткових залежностей.

Операційні системи рівня 1:

  • Linux x86_64 (дистрибутиви, сумісні зі специфікацією пакування manylinux 2014).
  • macOS x86_64 (10.12 або пізніша)
  • macOS ARM64 (11.0 або новіша)
  • Windows 64-bit (підтримується Windows 10 і пізніші)

Рівень 2

Операційні системи рівня 2 не тестуються як частина процесу розробки. Однак попередньо скомпільовані бінарні файли створюються, тестуються та публікуються на PyPI як частина процесу випуску, і ці пакети можна очікувати встановити лише з функціонуючим середовищем Python.

Операційні системи рівня 2:

  • Linux AArch64 (дистрибутиви, сумісні зі специфікацією пакування manylinux 2014)

Рівень 3

Операційні системи рівня 3 не тестуються як частина процесу розробки. Попередньо скомпільовані бінарні файли створюються та публікуються на PyPI як частина процесу випуску, але не тестуються. Вони можуть не встановлюватися лише з функціонуючим середовищем Python і можуть вимагати компілятор C/C++ або додаткові програми для збирання залежностей з джерельного коду як частина процесу встановлення. Підтримка цих операційних систем надається за принципом максимальних зусиль.

Операційні системи рівня 3:

  • Linux ppc64le (дистрибутиви, сумісні зі специфікацією пакування manylinux 2014)
  • Linux s390x (дистрибутиви, сумісні зі специфікацією пакування manylinux 2014)
  • Linux i686 (дистрибутиви, сумісні зі специфікацією пакування manylinux 2014)
  • Windows 10 32-bit

Наступні кроки​

Рекомендації