ai-sudoku-solver 1.0.7

A python library for solving sudoku puzzles using artificial neural networks

ai-Sudoku-Solver

Solving Sudoku Puzzles using Artificial Neural Networks

---

Table of Contents

• ai-Sudoku-Solver
  • Table of Contents
  • Installation
  • Usage
  • Model Gallery
  • References

---

Installation

pip install ai-sudoku-solver

---

Usage

Instantiate a SudokuSolver object

from ai_sudoku_solver import SudokuSolver

solver = SudokuSolver("Ritvik19/sudoku-net-v1")

Call the model on your puzzles

puzzle = np.array([[
    [0, 0, 4, 3, 0, 0, 2, 0, 9],
    [0, 0, 5, 0, 0, 9, 0, 0, 1],
    [0, 7, 0, 0, 6, 0, 0, 4, 3],
    [0, 0, 6, 0, 0, 2, 0, 8, 7],
    [1, 9, 0, 0, 0, 7, 4, 0, 0],
    [0, 5, 0, 0, 8, 3, 0, 0, 0],
    [6, 0, 0, 0, 0, 0, 1, 0, 5],
    [0, 0, 3, 5, 0, 8, 6, 9, 0],
    [0, 4, 2, 9, 1, 0, 3, 0, 0]
]])
solution = solver(puzzle)
# array([[
#     [8, 6, 4, 3, 7, 1, 2, 5, 9],
#     [3, 2, 5, 8, 4, 9, 7, 6, 1],
#     [9, 7, 1, 2, 6, 5, 8, 4, 3],
#     [4, 3, 6, 1, 9, 2, 5, 8, 7],
#     [1, 9, 8, 6, 5, 7, 4, 3, 2],
#     [2, 5, 7, 4, 8, 3, 9, 1, 6],
#     [6, 8, 9, 7, 3, 4, 1, 2, 5],
#     [7, 1, 3, 5, 2, 8, 6, 9, 4],
#     [5, 4, 2, 9, 1, 6, 3, 7, 8]
# ]])

---

Model Gallery

model	# parameters	trained on	accuracy
sudoku-net-v1	3,784,729	1M puzzles	98.138
sudoku-net-v2	3,784,729	10M puzzles	98.212

References

1. 1 million Sudoku games
2. 9 Million Sudoku Puzzles and Solutions