Skip to content

Marqed4/Sudoku

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

30 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation


SolveSudoku logo

𝑆𝑢𝑑𝑜𝑘𝑢

A full‑stack Sudoku solver, scanner, and generator

🌐 Visit us & learn more

🎮 Play


Upload a puzzle or perhaps generate one. If you're stuck get some hints or have us solve the puzzle entirely. Test your solution or check if the puzzle could be solved all along.

Views


Features

Instant Board Scanner - Snap a photo of any Sudoku puzzle and convert it into a clean, playable 9×9 grid using computer vision.

Smart Solver - Get a full solution instantly, powered by a backtracking + constraint-driven algorithm.

Hint Engine - Stuck on a puzzle? Request one or multiple hints, generated from the solved board and applied directly to your grid.

Puzzle Generator - Create fresh Sudoku boards on demand, with guaranteed solvability.

Board Editor - Manually tweak cells, fix mistakes.

Progress Persistence - Your board, hints, and state are saved automatically in local storage.

Error Checking - Optional real-time validation to catch duplicates and impossible moves.


Architecture

Class Diagram


Deployment

The app is split across two services hosted on Render:

Service Runtime Host
Sudoku Frontend Static Site (Vite build) Global CDN
Sudoku Backend Python / Flask + Gunicorn Virginia

The frontend is served as a static site via Render's global CDN. The backend runs as a persistent web service, handling API requests for puzzle generation, solving, hints, and image processing.


Ethics

SolveSudoku takes zero liability for puzzles you could've solved yourself.


Contributing

If you're considering contributing to Sudoku, first of all, thank you! Check the Contribution Guidelines before getting started.


License

Unless specified otherwise, this repository is licensed under AGPL-3.0