תוכן קוד פתוח של IBM Quantum
IBM מספקת שפע של חומרי למידה למחשוב קוונטי — כולם בקוד פתוח תחת רישיון CC BY-SA 4.0:
- Learning — קורסים מובנים מיסודות הקוונטים ועד נושאים מתקדמים
- Tutorials — למעלה מ־40 מדריכים על transpilation, הפחתת שגיאות ועוד
- Documentation — מדריכי עזר ומידע API עבור Qiskit
- Source repo — כל התוכן ב־GitHub
ה־Quantum Platform שלהם מעודכן תמיד ומעוצב היטב — המקום הטוב ביותר לקריאה, למידה ועיון.
מה הפרויקט הזה מוסיף
התיעוד של Qiskit של IBM הוא קוד פתוח (CC BY-SA 4.0), אבל אפליקציית הווב שלהם לא. doQumentation מוסיף ממשק קוד פתוח עם הרצת קוד חיה, הזרקת אישורים אוטומטית ומצב סימולטור.
ניתן לפריסה בכל מקום — מ־GitHub Pages דרך Docker ועד RasQberry. ראו את כל התכונות.
התחלה
חדש במ חשוב קוונטי? התחל עם הקורס. כבר מכיר את Qiskit? קפוץ ישר למדריך או מדריך עזר.
אין לך חשבון IBM Quantum? הפעל מצב סימולטור בהגדרות כדי להריץ את כל הקוד ללא הרשמה.
הרצת קוד
לחץ על Run בכל בלוק קוד. הלחיצה הראשונה מפעילה ליבת Jupyter חינמית דרך Binder or IBM Code Engine (דקה עד שתיים). לאחר מכן, ההרצות מיידיות.
-
מצב סימולטור (ללא צורך בחשבון) — הפעל מצב סימולטור להרצת כל המחברות עם AerSimulator או FakeBackends עם מודל רעש. אפס התקנה נדרשת.
-
חומרה קוונטית של IBM Quantum — הזן את ה־API token וה־CRN שלך בהגדרות פעם אחת — האישורים מוזרקים אוטומטית בכל הרצה. צור חשבון חינמי אם אין לך כזה.
מנועי הרצה זמינים
לכל מדריך יש בלוקי קוד להרצה. לחץ על Run להרצתם באמצעות אחד משלושת המנועים:
- Binder (ברירת מחדל ב־GitHub Pages) — ליבת Jupyter מרוחקת בחינם דרך mybinder.org
- Jupyter מקומי (Docker / RasQberry) — מתחבר לשרת Jupyter המקומי עם Qiskit מותקן מראש
- שרת מותאם אישית — הפנה לכל נקודת קצה Jupyter בהגדרות
When multiple backends are available, choose which one to use from Settings.
אפשרויות פריסה
doQumentation זמין כ:
- GitHub Pages — אתר סטטי עם Binder or IBM Code Engine להרצת קוד מרוחקת
- Docker — מערכת מלאה מקומית, ניתנת לעבודה לא מקוונת
- RasQberry — אירוח עצמי על Raspberry Pi עם ליבת Jupyter מקומית
הרצה מקומית עם 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), כך ש־Mac עם Apple Silicon עובדים באופן טבעי.