Contributing to RasQberry
We welcome contributions to this quantum computing education project!
How to Contribute
1. Test & Report Issues
The most valuable contribution is testing and reporting bugs:
- Try out RasQberry on your hardware
- Report issues with clear steps to reproduce
- Include error messages, screenshots, and hardware details
2. Share Ideas & Feature Requests
Have ideas for improvements?
- Open a GitHub Discussion or issue
- Suggest new demos, UX improvements, or educational features
3. Improve Documentation
Help make RasQberry easier to use:
- Fix typos or unclear instructions
- Add troubleshooting tips
- Use the "Edit this page" link at the bottom of any page
4. Create Quantum Demos
Build new interactive demonstrations:
- Create your demo using Python and Qiskit
- Package it in a GitHub repository with
requirements.txtandREADME.md - Integrate with RasQberry (launcher script, menu entry)
- Submit a pull request
Example demos for inspiration:
- Quantum Lights Out - Puzzle game with quantum algorithms
- Raspberry Tie - LED visualization of quantum circuits
- Bloch Sphere - Interactive qubit state visualization
Quick Links
| Resource | Link |
|---|---|
| Report Issues | GitHub Issues |
| Discussions | GitHub Discussions |
| Existing Demos | Demo List |
| Project Repository | RasQberry-Two |
Resources
Learning Qiskit:
Development:
- Python 3.11+, Raspberry Pi 4 or 5
- RasQberry OS image from releases