Maze Solver 🐍

2025-08-21.12-37-51.mp4

A maze solver visualizer inspired by the Frontend Masters Algorithms course taught by ThePrimeagen. This project demonstrates recursion in action by visually solving mazes in real time. Perfect for learning and experimenting with algorithmic thinking!

Features

• Visualizes maze solving step by step.
• Helps understand recursion through animation.
• Simple and lightweight Python project.
• It's possible to create custom mazes and run them inside the application.

Custom Mazes

In order to create a custom maze, create a file inside the folder mazes. The file must be a text file and you can draw any kind of maze you want. Right after the maze, the coordinates for starting point and ending point must be provided. If you want a template to follow, please see this one or this one.

###### #
#   #  #
# #   ##
# ######
1,3
6,0

Now, simply adjusts the path in the code from maze = create_maze_from_file("./mazes/maze_2.txt") to maze = create_maze_from_file("./mazes/your_custom_maze.txt").

Requirements

• Python 3.12.3 or newer.
• Tkinter (Python's built-in GUI library).

Installing Tkinter

• Ubuntu / WSL:

  sudo apt install python3-tk -y

• Windows / macOS: Usually comes pre-installed with Python.

How to Run

1. Clone the repository:

   git clone https://github.com/leo-bloise/maze-solver.git
   cd maze-solver

2. Run the application:

   python main.py