Skip to content

hasan-alper/lucca

Repository files navigation

lucca

About Lucca

Lucca allows users to quickly and easily solve a Sudoku puzzle by simply taking a picture of the puzzle with their camera. The image is then processed using some image processing techniques to extract the puzzle from the background and identify each individual cell. Next, a convolutional neural network (CNN) model, trained on the MNSIT dataset, is used to accurately predict the digits in each cell. Once all the digits have been identified, a backtracking algorithm is employed to solve the puzzle. Finally, the solution is written directly onto the original image.

lucca

Installation

In order to play around with the project, you can set up this repository locally following these simple steps.

Note that in order to avoid potential conflicts with other packages, it is strongly recommended to use a virtual environment or a conda environment.

  1. Clone the repo
    git clone https://github.com/hasan-alper/lucca.git
  2. Move inside your copy
    cd lucca
  3. Create a virtual environment
    virtualenv [my_virtual_env_name]
  4. Active the virtual environment
    source [my_virtual_env_name]/bin/activate
  5. Install necessary packages
    pip install -r requirements.txt

Contributing

Any contributions are welcome. Feel free to create a pull request to improve one or two things. If you find any bugs/issues, you can also simply open an issue.

License

Distributed under the MIT License. See LICENSE for more information.