https://github.com/oscarhiggott/pewpew-qube

Quantum rubiks' cube on a pewpew for the IBM QISKIT Europe hackathon 2019
https://github.com/oscarhiggott/pewpew-qube

Last synced: 3 months ago
JSON representation

Quantum rubiks' cube on a pewpew for the IBM QISKIT Europe hackathon 2019

• Host: GitHub
• URL: https://github.com/oscarhiggott/pewpew-qube
• Owner: oscarhiggott
• Created: 2019-09-13T10:00:09.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2019-11-10T19:34:19.000Z (about 5 years ago)
• Last Synced: 2024-05-20T03:19:47.396Z (8 months ago)
• Language: Python
• Size: 1.03 MB
• Stars: 4
• Watchers: 5
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• Awesome-Quantum-Games - PewPew-Qube - An implementation of a quantum version of the Rubik’s cube on a PewPew device. (by Oscar Higgott, Radomir Dopieralski, ...) (2019 / Qiskit Camp Europe)

README

        
# pewpew-qube

An implementation of a quantum version of the Rubik's cube on a [PewPew device](https://pewpew.readthedocs.io/en/latest/), using [MicroQiskit](https://github.com/quantumjim/MicroQiskit). This game was created at Qiskit Camp Europe 2019.

## Usage

### Emulator

The game can be run on a standard computer with Python 3 using the [emulator](https://pewpew.readthedocs.io/en/latest/pewmulator.html), which is included in this repo in the pew.py file. Using the emulator requires [pygame](https://www.pygame.org/wiki/about) to be installed.

### PewPew

Unlike the emulator, the PewPew only has 32kB of RAM, imposing more restrictions on what games can be run. The `*.py` files (excluding the `pew.py` emulator file) in the `src` directory could usually just be placed directly on the PewPew if RAM was not an issue, which would then run `code.py` using [CircuitPython](https://circuitpython.org/). However, to fit this game in memory, it is instead necessary to transfer the precompiled bytecode in the `mpy` directory onto the device.