README.md

image-puzzle-game

A 3 x 3 grid semi-interactive image puzzle game built entirely using the Pillow Python library.

• Designed to be executed in an Interactive Python notebook environment.

Demo

1. Access the demo notebook here
2. Log into your Google Account.
3. Press the round play (run) button.
4. Enjoy the game!

Installation

In a Jupyter Notebook Environment:

1. Run !pip install image-puzzle-game
2. Run the following in a code cell of your notebook:

from image_puzzle_game import play
play()

3. Enjoy the game!

How to Play

1. Enter the number of the tile you would like to move (displayed on the tiles from 1 to 8).
2. Enter the position on the grid you would like to move the tile to.
   • The 3 x 3 grid is labelled with positions from 1 to 9 starting from the upper left corner down to the lower right.
3. Each tile can only be moved either vertically or horizontally to an adjacent empty position but not diagonally.
4. Move the tiles until they have aligned to form the correct image.