시작하기

설치

QXel은 소스에서 빌드하는 고성능 GPU 가속 양자 회로 시뮬레이터입니다. 현재 Linux에서 동작합니다.

사전 요구 사항

빌드하기 전에 다음을 설치하세요. 아래 버전은 QXel이 테스트한 버전이며, 보통 더 낮은 버전도 동작합니다. • Python ≥ 3.13.11 (Python ≥ 3.14는 AWS Braket SDK와 호환되지 않습니다) • CMake ≥ 4.1.2 • Ninja ≥ 1.13.1 • pybind11 ≥ 2.13.6 • MKL 및 mkl-include ≥ 2025.0.0

참고 QXel은 현재 Linux 전용입니다. Windows의 경우 팀에 문의하여 액세스를 요청하세요.

소스에서 빌드하기

저장소를 클론한 뒤 pip로 설치하세요. 이 과정에서 C++/CUDA 백엔드를 컴파일하므로, 첫 설치에는 몇 분이 걸립니다.

bash
git clone https://github.com/QubiStack/QXel
cd QXel
pip install .

빌드 실패 문제 해결

빌드가 실패하면(예를 들어 의존성을 업그레이드한 뒤), 빌드 디렉터리를 삭제하고 다시 설치하세요:

bash
rm -rf build
pip install .