Skip to main content
IBM Quantum Platform

키스킷 설치

로컬에서 작업하든 클라우드 환경에서 작업하든 모든 사용자의 첫 번째 단계는 키스킷을 설치하는 것입니다.

Qiskit SDK 설치하기

  1. python을 설치하십시오. Qiskit PyPI 프로젝트 페이지의 “프로그래밍 언어” 섹션을 확인하여 최신 릴리스에서 지원하는 Python 버전을 확인하십시오. 다운로드 방법은 ‘ Python 초보자 가이드’를 참조하십시오.

    Qiskit을 다른 애플리케이션과 분리하려면 Python 가상 환경을 사용하는 것이 좋습니다.

    Note

    이 지침은 표준 Python 배포판을 사용합니다 pypi.org. 그러나 Anaconda 또는 미니콘다와 같은 다른 Python 배포판을 Poetry와 같은 다른 종속성 관리 워크플로와 함께 사용할 수 있습니다.

    • 가상 Python 환경은 특정 목적을 위해 Python 에서 작업할 수 있는 격리된 공간으로, 컴퓨터의 "기본" Python 환경에 영향을 주지 않으면서 원하는 패키지를 설치하고 라이브러리, 종속성 등을 설정할 수 있습니다.

      가상 환경의 중요한 장점 중 하나는 Python 환경이 도중에 손상되는 경우 가상 환경을 쉽게 삭제하고 다시 시작할 수 있다는 것입니다!

      가상 환경에 대한 정보를 저장할 기본 위치를 선택합니다. 일반적으로 작업 중인 각 프로젝트 디렉터리 내의 .venv 디렉터리에 저장됩니다.

    먼저 프로젝트 디렉터리로 이동하여 Python 만 설치한 최소한의 환경을 만듭니다.

    python3 -m venv .venv

    다음으로 새 환경을 활성화합니다.

    source .venv/bin/activate

  2. 사용자 환경에 아직 설치되어 있지 않은 경우 pip를 설치합니다. Pip은 키스킷 및 기타 Python 패키지를 설치하는 데 사용하는 Python 패키지 관리자입니다. pip list 을 사용하여 가상 환경에 무엇이 있는지 확인하세요. 대부분의 Python 환경에서는 pip가 이미 설치되어 있습니다.

  3. Qiskit SDK 를 설치하십시오.

    pip install qiskit
    시각화 지원 추가

    시각화 기능이나 Jupyter 노트북을 사용하려는 경우 해당 qiskit.visualization 모듈도 설치하십시오. 자세한 내용은 시각화 API 참조 문서를 참조하십시오.

  1. 방금 설치한 키스킷 패키지로 Jupyter 노트북을 실행하려면 사용자 환경에 Jupyter를 설치해야 합니다.

    pip install jupyter

    그런 다음 다음과 같이 노트북을 엽니다:

    jupyter notebook <path/to/notebook.ipynb>

현지에서 작업하고 Qiskit에 내장된 시뮬레이터를 사용할 계획이라면, 설치는 완료된 것입니다. IBM® 의 QPU에서 작업을 실행하려면, IBM Cloud® 계정을 설정해 주세요.

최신 버전으로 최신 상태 유지

새로운 릴리스가 있는지 확인하려면 주기적으로 Qiskit 릴리스 노 트를 확인하세요. 다음 명령을 qiskit 실행하여 요구 사항을 자주 pip install -U qiskit업데이트할 것을 권장합니다.

문제점 해결

  • pip install qiskit 을 사용하여 가상 환경을 설정한 경우 에서 가상 환경을 설정한 경우 자습서를 실행할 때 No Module 'qiskit' 오류가 발생할 수 있습니다 를 실행할 때 Jupyter Notebook 오류가 발생할 수 있습니다. Qiskit을 설치하지 않았거나 가상 환경을 설정하지 않은 경우 설치 단계를 따르세요.

    이 오류는 키스킷이 설치되지 않은 환경에서 키스킷 패키지를 가져오려고 할 때 발생합니다 환경에서 키스킷 패키지를 가져오려고 할 때 발생합니다. 를 실행한 경우 Jupyter Notebook 를 실행한 경우- Navigator, Jupyter Notebook 이 가상 환경이 아닌 기본(루트) 환경에서 실행 중일 수 있습니다 가 가상 환경이 아닌 기본(루트) 환경에서 실행 중일 수 있습니다 환경이 아닌 기본(루트) 환경에서 실행 중일 수 있습니다. 아나콘다( Navigator )에서 가상 환경을 선택합니다 애플리케이션 드롭다운 메뉴에서 선택합니다. 이 메뉴에서 다음을 볼 수 있습니다 아나콘다 내의 모든 가상 환경을 볼 수 있으며, 다음을 수행할 수 있습니다 키스킷이 설치된 환경을 선택하여 Jupyter Notebook 을 실행할 수 있습니다.

  • 키스킷은 다른 여러 오픈소스 Python 패키지에 의존하고 있으며, 이는 pip install qiskit를 실행할 때 자동으로 설치됩니다. 에 따라 시스템 플랫폼 및 Python 버전에 따라 특정 패키지가 시스템에 미리 빌드된 바이너리를 제공하지 않을 수 있습니다. 키스킷이 지원하는 플랫폼 목록은 키스킷이 지원하는 플랫폼 목록은 운영체제 지원을 참조하세요 중 일부는 추가 컴파일러가 필요할 수 있습니다. 다음과 같은 경우 사용 가능한 사전 컴파일된 바이너리가 없는 경우, 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)에서 소스에서 컴파일하는 데 필요한 라이브러리를 설치하는 방법( 를 설치하는 방법에 대한 정보를 확인하세요.

운영 체제 지원

키스킷은 가능한 한 많은 운영 체제를 지원하기 위해 노력하지만 사용 가능한 테스트 리소스와 운영 체제 가용성의 제한으로 인해 모든 운영 체제를 지원할 수 없습니다. 키스킷에 대한 운영 체제 지원은 세 가지 티어로 나뉘며, 각 티어마다 지원 수준이 다릅니다. FreeBSD 또는 WebAssembly (WASI)와 같은 플랫폼의 경우, 키스킷을 설치할 수 있지만 테스트되지 않았으므로 소스에서 키스킷(및 키스킷의 종속성)을 빌드해야 합니다.

또한, 키스킷은 Python 언어의 CPython 구현만 지원합니다. PyPy 등의 다른 Python 통역사와 함께 실행하는 것은 지원되지 않습니다.

Qiskit v2.x

키스킷 v2.x 릴리스 시리즈에서 지원되는 플랫폼은 다음과 같습니다:

  • 티어 1 운영 체제는 개발 프로세스의 일부로 제안된 변경 사항이 올바르게 작동하는지 확인하기 위해 전체 테스트를 거칩니다. 사전 컴파일된 바이너리는 릴리스 프로세스의 일부로 빌드, 테스트 및 PyPI 에 게시됩니다. 일반적으로 정상적으로 작동하는 Python 환경이 설치되어 있으면 추가 종속성을 설치할 필요 없이 이러한 운영 체제에 키스킷을 설치할 수 있습니다.

    티어 1 운영 체제:

    • Linux x86_64 ( 많은 리눅스 2014 패키징 사양과 호환되는 배포판).
    • macOS ARM64 ( 11.0 이상)
    • Windows 64비트(Windows 10 이상 지원)
    • Linux AArch64 ( 많은 리눅스 2014 패키징 사양과 호환되는 배포판)

  • 2단계 운영체제는 개발 과정의 일환으로 테스트되지 않습니다. 그러나 사전 컴파일된 바이너리는 릴리스 프로세스의 일환으로 빌드, 테스트 및 PyPI 에 게시되며, 이러한 패키지는 정상 작동하는 Python 환경만 있으면 설치될 수 있을 것으로 예상됩니다. 이러한 시스템용 패키지 출시에는 지연이 발생할 수 있습니다. 테스트 실패가 훨씬 나중에야 감지될 수 있으며, 게시 과정 중 발생한 실패는 Tier 1 시스템용 패키지 게시를 차단하지 않기 때문입니다.

    티어 2 운영 체제:

    • macOS x86_64 ( 10.12 이상)

  • 티어 3 운영 체제는 개발 프로세스의 일부로 테스트되지 않습니다. 사전 컴파일된 바이너리는 릴리스 프로세스의 일부로 빌드되어 PyPI 에 게시되지만 테스트되지는 않습니다. Python 환경만으로는 설치가 불가능할 수 있으며 설치 과정의 일부로 소스에서 종속성을 빌드하기 위해 C/C++ 컴파일러 또는 추가 프로그램이 필요할 수 있습니다. 이러한 운영 체제에 대한 지원은 최선의 노력으로만 이루어집니다.

    티어 3 운영 체제:

키스킷( v2.0.0 )에서는 64비트 플랫폼만 지원되며 32비트 플랫폼은 지원되지 않습니다. 32비트 플랫폼에서는 소스에서 빌드할 수 없습니다 를 32비트 플랫폼에서는 빌드할 수 없습니다. 내부적으로 키스킷 러스트 코드는 64비트 포인터 폭을 가정하기 때문입니다.

다음 단계

권장사항
이 페이지가 도움이 되었습니까?
GitHub에서 버그, 오타를 보고하거나 컨텐츠를 요청하십시오.