주 콘텐츠로 건너뛰기

doQumentation

doQumentation은 IBM Quantum의 완전한 오픈소스 튜토리얼, 강좌 및 문서 라이브러리에 기능이 풍부하고 사용하기 편한 오픈소스 프론트엔드를 추가합니다.

42Tutorials
171가이드
154강좌 페이지
14모듈

IBM Quantum의 오픈소스 콘텐츠​

IBM은 양자 컴퓨팅 학습 자료를 풍부하게 제공합니다 — 모두 CC BY-SA 4.0 라이선스의 오픈소스입니다:

  • Learning — 양자 기초부터 고급 주제까지 체계적인 강좌
  • Tutorials — transpilation, error mitigation 등에 관한 40개 이상의 tutorials
  • Documentation — Qiskit 가이드 및 API 레퍼런스
  • Source repo — GitHub의 모든 콘텐츠

그들의 Quantum Platform은 항상 최신 상태이며 잘 설계되어 있습니다 — 읽고, 배우고, 참고하기에 가장 좋은 곳입니다.

이 프로젝트가 추가하는 것​

IBM의 Qiskit 문서는 오픈소스(CC BY-SA 4.0)이지만, 그들의 웹 애플리케이션은 그렇지 않습니다. doQumentation은 라이브 코드 실행, 자동 자격 증명 주입, 시뮬레이터 모드를 갖춘 오픈소스 프론트엔드를 추가합니다.

어디서든 배포 가능합니다 — GitHub Pages부터 Docker, RasQberry까지. 모든 기능을 확인해 보세요.

시작하기​

양자 컴퓨팅을 처음 접하시나요? 강좌부터 시작하세요. Qiskit에 이미 익숙하다면? 바로 tutorial이나 가이드로 넘어가세요.

IBM Quantum 계정이 없으신가요? 설정에서 시뮬레이터 모드를 활성화하면 가입 없이 모든 코드를 실행할 수 있습니다.

강좌양자 정보의 기초여기서 시작하세요 — 단일 시스템부터 얽힘까지 체계적인 강좌TutorialHello World: 첫 번째 양자 회로doQumentation의 자체 입문 — Bell 상태 만들고 세 가지 방법으로 실행하기가이드Hello WorldIBM의 시작 가이드 — 첫 번째 Qiskit 프로그램TutorialCHSH 부등식양자 컴퓨터에서 Bell 검정 실행하기TutorialQAOA를 위한 고급 기법고급 최적화 기법으로 대규모 QAOA 성능 향상시키기

코드 실행​

코드 블록에서 Run을 클릭하세요. 첫 번째 클릭은 Binder 또는 IBM Code Engine을 통해 Jupyter 커널을 시작합니다. 그 이후 실행은 즉각적입니다.

  • 시뮬레이터 모드 (계정 불필요) — 시뮬레이터 모드를 활성화하면 AerSimulator 또는 노이즈 모델 FakeBackends로 모든 노트북을 실행할 수 있습니다. 설정이 전혀 필요 없습니다.

  • IBM Quantum 하드웨어 — 설정에 API 토큰과 CRN을 한 번만 입력하면 — 실행할 때마다 자격 증명이 자동으로 주입됩니다. 계정이 없다면 무료 계정을 만드세요.

사용 가능한 실행 백엔드

모든 tutorial에는 실행 가능한 코드 블록이 있습니다. Run을 클릭해서 네 가지 백엔드 중 하나로 실행하세요:

  1. Binder (GitHub Pages 기본값) — mybinder.org를 통한 무료 원격 Jupyter 커널
  2. IBM Code Engine — IBM Cloud 계정의 서버리스 Jupyter. 콜드 스타트가 분 단위가 아닌 초 단위. 설정
  3. 로컬 Jupyter (Docker / RasQberry) — Qiskit이 사전 설치된 로컬 Jupyter 서버에 연결
  4. 커스텀 서버 — 설정에서 임의의 Jupyter 엔드포인트 지정

여러 백엔드가 사용 가능한 경우, 설정에서 사용할 백엔드를 선택하세요.

배포 옵션

doQumentation은 다음과 같이 제공됩니다:

  • GitHub Pages — Binder 또는 IBM Code Engine을 이용한 원격 코드 실행이 가능한 정적 사이트
  • Docker — 로컬 풀 스택, 오프라인 사용 가능
  • RasQberry — 로컬 Jupyter 커널을 갖춘 Raspberry Pi 자체 호스팅
Podman / Docker로 로컬 실행하기

Podman Desktop 또는 Docker Desktop (Mac / Windows / Linux)을 설치한 후 실행하세요:

# Full stack: site + Jupyter + Qiskit (~3 GB)
podman run -p 8080:80 -p 8888:8888 ghcr.io/janlahmann/doqumentation:jupyter

http://localhost:8080을 열면 — 코드 실행이 로컬에서 작동하고, Binder 대기 시간이 없습니다.

로컬 코드 실행 없이 가벼운 버전을 원한다면 (~60 MB):

# Static site only — code execution still works via Binder
podman run -p 8080:80 ghcr.io/janlahmann/doqumentation:latest

Docker를 사용하시나요? podman을 docker로 바꾸기만 하면 됩니다 — 명령어는 동일합니다. 이미지는 멀티 아치(linux/amd64 + linux/arm64)이므로 Apple Silicon Mac에서도 네이티브로 작동합니다.