README.md

---
title: Maze Generator
emoji: 🎯
colorFrom: blue
colorTo: purple
sdk: gradio
sdk_version: 5.46.1
app_file: app.py
pinned: false
license: mit
---

# Maze Generator

A Gradio web interface that generates custom maze PDFs from https://www.mazegenerator.net/ with customizable dimensions and quantities.

## Features

- Generate multiple maze PDFs with specified dimensions
- Extract only the first page from each PDF (to remove solution pages)
- Web interface with progress tracking
- Merge multiple PDFs into a single file
- Real-time file list updates

## How to Use

1. **Generate Mazes Tab:**
   - Set the number of mazes you want to generate (1-50)
   - Specify width and height in cells (2-200)
   - Click "Generate Mazes" to create the PDFs
   - View generated files in the file list

2. **Merge PDFs Tab:**
   - Click "Merge All PDFs" to combine all PDFs in the pdfs/ directory
   - The merged file will be saved as `merged_mazes.pdf`
   - Individual files will be deleted after merging

## Technical Details

- Each maze is generated with random patterns
- PDFs are saved in the `pdfs/` directory
- File naming pattern: `maze_{width}x{height}_{number}.pdf`
- The app automatically handles file name conflicts by incrementing numbers

## Dependencies

- `gradio`: Web interface framework
- `pandas`: Data manipulation
- `pypdf`: PDF processing and merging
- `requests`: HTTP requests to maze generator API

## Deployment

This app is designed to be deployed on Hugging Face Spaces. The deployment configuration is specified in the front matter of this README.md file.

## Local Development

To run this app locally:

1. Clone the repository
2. Create a virtual environment: `python -m venv venv`
3. Activate the environment: `source venv/bin/activate` (Linux/Mac) or `venv\Scripts\activate` (Windows)
4. Install dependencies: `pip install -e .`
5. Run the app: `python app.py`

The app will be available at `http://localhost:7861`