An application that is able to read and solve a Sudoku thantks to machine learning.
Explore the docs »
Report Bug
·
Request Feature
Table of Contents
The goal of this project is to build an application to read a sudoku puzzle from a picture and solve it using CSP (Constraint Satisfaction Problems).
This project is based on Python. No framework is needed, but you must install the PySide6 package. We strongly suggest your to create a virtual environment to create the app environment. You can also use the Dockerfile to use with Docker.
Before clonning the repository, you should create a new virtual environment (using venv for exemple).
- Clone the project (or use the src folder)
git clone https://github.com/killian-mahe/sudoku-reader.git
- Install the virtual environment
cd sudoku-reader && python3 -m venv env
- Activate the new environment (on Linux)
source env/bin/activate - Activate the new environment (on Windows with powershell)
env\Scripts\Activate
- Activate the new environment (on Windows with CMD)
env\Scripts\activate.bat
- Install required packages
pip3 install -r requirements.txt
- Start the project
python sudoku_reader
- Add flask to env path (on powershell)
$env:FLASK_APP = "server"
- Add flask to env path (on CMD)
set FLASK_APP=server - Start the server
cd sudoku_reader flask run --host=0.0.0.0
See the open issues for a list of proposed features (and known issues).
Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request
Distributed under the MIT License. See LICENSE for more information.
Killian Mahé - @killian-mahe - killianmahe.pro@gmail.com
Project Link: https://github.com/killian-mahe/sudoku-reader