Skip to content

Latest commit

 

History

History

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 

README.md

Sudoku Game

A simple Sudoku game built with Python and Streamlit. This interactive app allows users to solve Sudoku puzzles using numbers or letters, with features to track completion time and verify the solution.

Features

  • Play with Numbers or Letters: Choose between traditional numbers or letters (A-I) to fill the Sudoku grid.
  • Time Tracking: The game displays the time taken to complete the puzzle in seconds.
  • Check Solution: After filling the grid, use the "Check Solution" button to verify your answer.
    • Correct Solution: Displays a congratulatory message— "Congratulations! You solved the Sudoku."
    • Incorrect Solution: Displays an error message— "There are some mistakes in your solution. Try again!"

Getting Started

Prerequisites

  • Python 3.x installed on your machine
  • Streamlit library installed

You can install Streamlit using the following command:

pip install streamlit

Installation

  1. Clone this repository:

    git clone https://github.com/DianaMPaun/GAMES/tree/main/Sudoku
    cd sudoku-game
  2. Run the Streamlit app:

    streamlit run sudoku_app.py

How to Play

  1. Open the app using the streamlit run command mentioned above.
  2. Select whether you want to play with numbers or letters.
  3. Fill in the grid following standard Sudoku rules.
  4. Click on Check Solution when you are done.
  5. If the solution is correct, you will see "Congratulations! You solved the Sudoku." Otherwise, you’ll be prompted to correct any errors.

Streamlit App

I created a Streamlit app for this game, and you can access it by clicking here: sudoku

Screenshot

image

Technologies Used

  • Python
  • Streamlit

Contributing

If you find any bugs or have suggestions for improvements, feel free to open an issue or submit a pull request.