Rubik's Cube Solver

A Jupyter notebook that enables you to upload pictures of your unsolved Rubik's cube and receive a full solution. It uses opencv-contrib-python, a Python library built on top of OpenCV, capable of performing various computer vision tasks.

Getting Started:

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.

Installing

Clone the repository with:

$ git clone git@github.com:mazenkurdi/rubiks-cube-solver.git

To install dependencies, run:

pipenv shell
pipenv install

Running

1. Launch Jupyter notebook found in this project
2. You must use the original Rubik’s cube (3 x 3) that can be found here: https://www.rubiks.com/en-us/rubik-s-cube-3x3.html
3. The cube must be placed on a flat, smooth surface (preferably a white paper)
4. Take a picture of each side of the cube (keep track of the sides)
5. Upload the images to the program and assign to the correct variable (indicating the side of the cube)
6. Then run the entire notebook