Skip to content

Sudoku solver with various features of solving and hinting for the user combined with simple UI

Notifications You must be signed in to change notification settings

danildenha/Sudoku-Solver

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 

Repository files navigation

Sudoku Solving App

Introduction

This Sudoku Solving App is a Python program that utilizes the Pygame library to create an interactive interface for solving Sudoku puzzles. It is designed to allow users to input their own Sudoku puzzles, receive step-by-step solving visualizations, and view the solution.

Prerequisites

Before running the program, make sure you have Python and Pygame installed on your system. You can install Pygame using the following command:

pip install pygame

How to Run

  1. Clone the repository to your local machine:

git clone https://github.com/your-username/sudoku-solving-app.git
  1. Navigate to the project directory:

cd sudoku-solving-app
  1. Run the main Python script:

python main.py

Features

Sudoku Board Interaction:

  • Adding Numbers: Left-click on a cell and press a number key to add a number to the board.
  • Deleting Numbers: Left-click on a cell and press the backspace key to delete a number.
  • Step-by-Step Visualization: Press the spacebar to initiate step-by-step solving visualization.
  • Show Solution: Press 'S' to reveal the complete solution of the puzzle.
  • Cell Hint: Choose a cell, and press 'C' to see the correct answer for that cell.

Implementation Details

  • 2D Matrix Array: The Sudoku board is represented as a 2D matrix array, making it convenient for handling cell values.
  • Object-Oriented Programming: The code follows an object-oriented approach to encapsulate the Sudoku board and its functionalities.

Usage Instructions

  1. Launch the application by running main.py
  2. Interact with the Sudoku board using the specified key commands.
  3. Enjoy solving Sudoku puzzles with helpful features and visualizations.

Known Issues

At present, there are no known issues. If you encounter any problems, please report them in the GitHub issues section. Contribution Guidelines

If you would like to contribute to the project, please follow these guidelines:

  1. Fork the repository.
  2. Create a new branch for your feature or bug fix.
  3. Make your changes and submit a pull request.

About

Sudoku solver with various features of solving and hinting for the user combined with simple UI

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages