Project README - Phase 1

Getting access to the repo

This repository is currently private. If you want access before Phase 2‘s public release, please contact us via email or phone.

Clone it

git clone git@github.com:sharqawycs/jigsaw-puzzle-solver.git

Installation & Environment

The project is tested on Python 3.11 and 3.12 on Arch Linux, Windows 11, and MacOS 26.

1. Install dependencies:

   pip install -r requirements.txt

2. Put your puzzle images in data/puzzle_NxN/ folders (it‘s already there for you)
3. Open and run phase1.ipynb in Jupyter
4. You will find the processed tiles in output/puzzle_NxN/ folders