RasQberry is a functional model of IBM Quantum System Two. It integrates Qiskit, a Raspberry Pi and a 3D printed model of IBM Q System Two to explore various state-of-the-art technologies and create a tool that can be used for education and in meetings, meetups, demo booths, etc. A spectrum of Quantum Computing demos and Serious Games for Quantum Computing (that illustrate e.g. superposition, interference and entanglement) will be made available on the RasQberry platform for an engaging introduction to Quantum Computing.
Note: If you are looking for the functional model of IBM Quantum System ONE, please go to https://rasqberry.one. Here is the new project, building a functional model of IBM Quantum System TWO, including several additional updates, e.g. 64-bit OS, Raspberry Pi 5, Qiskit 2.x, more Quantum Computing Demos, integration into raspi-config, etc.
See It In Action
3D-printed model inspired by IBM Quantum System Two
Demo video showing RasQberry Two beta with quantum computing demos
Interactive quantum computing demos - Bloch sphere visualization, quantum games, circuit composer, and fractal animations (slow-motion version)
Getting Started
1. Write the image. With Raspberry Pi Imager 2.0.3+ installed, this opens it pre-loaded with the RasQberry images:
Confirm the security prompt, choose a RasQberry image under Choose OS, and write it to an SD card. No customisations needed.
2. Boot your Pi and log in. SSH and VNC both work out of the box — username rasqberry, password Qiskit1!.
3. Answer the setup questions on first login (below), then start a demo.
The link did nothing, or you don't have Imager yet
The link needs Raspberry Pi Imager 2.0.3 or newer — install it and click again. If still nothing happens, your browser may not hand rpi-imager:// links to the app. Any of these work instead:
Add the repository by hand. In Imager: App Options (bottom-left) → Content Repository → Use custom URL → paste https://RasQberry.org/RQB-images.json → Apply & Restart.
Download the image yourself. Browse rasqberry.org/latest/ for stable, beta and development builds, then write it with Imager like any other image.
Start Imager from the command line.
# macOS
/Applications/Raspberry\ Pi\ Imager.app/Contents/MacOS/rpi-imager --repo https://RasQberry.org/RQB-images.json
# Windows
"C:\Program Files (x86)\Raspberry Pi Imager\rpi-imager.exe" --repo https://RasQberry.org/RQB-images.json
First boot
The first time you log in, RasQberry offers the setup steps that still need a decision from you. Nothing happens behind your back, and it stops asking once they are done:
- Check the LED panel. An IBM logo appears on your panel and you pick the colour that shows it upright — that tells RasQberry how your LEDs are wired and which way up they are mounted. Nothing to do if you have no panel.
- Expand the partitions. Only on the A/B image, which ships with a placeholder second slot and needs a 64GB or larger card. Worth doing first: until you do there is nowhere to put a second system, and the disk is nearly full.
Both are available later from sudo raspi-config → 0 RasQberry.
Then try something: double-click a demo icon on the desktop, or see the demo list — 17 demos ship with the image. Found a bug? Open an issue.
Working with Qiskit
Qiskit comes pre-installed in the default virtual environment (RQB2).
Activate the environment:
source /home/rasqberry/RasQberry-Two/venv/RQB2/bin/activate
Check installed packages:
(RQB2) rasqberry@raspberrypi:~ $ pip list | grep qiskit
qiskit 2.0.1
qiskit-aer 0.15.1
qiskit-ibm-runtime 0.30.0
qiskit-qasm3-import 0.5.1
Note: Package versions shown are examples. Use
pip list | grep qiskitto see your current installation.
Building the RasQberry 3D Model
STL files for the 3D-printed model are available in the 3D-model branch. The model consists of several printed parts that assemble together to create the complete RasQberry Two enclosure.
Exploded view showing all 3D-printed components
For detailed assembly instructions, see the Hardware Assembly Guide.
Contributing
RasQberry is an open-source educational project. We welcome contributions:
- Test & report issues - Try RasQberry and report bugs
- Share ideas & feature requests - Open a GitHub Discussion or issue
- Improve documentation - Fix typos or add troubleshooting tips using the "Edit this page on GitHub" link on each page
- Create quantum demos - Build new interactive demonstrations
Get Started: Visit our Contributing Guide to learn more.
Stay Updated
Follow our Announcements on GitHub Discussions for the latest news and updates.
Subscribe to our newsletter for occasional updates on new releases, quantum computing demos, and community news. We send not more than one email per month.
Need Help?
Try our AI-powered documentation assistant based on Google NotebookLM to ask questions about RasQberry setup, demos, and troubleshooting (login with your Google ID required). 