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:

  1. Create your demo using Python and Qiskit
  2. Package it in a GitHub repository with requirements.txt and README.md
  3. Integrate with RasQberry (launcher script, menu entry)
  4. Submit a pull request

Example demos for inspiration:

ResourceLink
Report IssuesGitHub Issues
DiscussionsGitHub Discussions
Existing DemosDemo List
Project RepositoryRasQberry-Two

Resources

Learning Qiskit:

Development:

  • Python 3.11+, Raspberry Pi 4 or 5
  • RasQberry OS image from releases