Puzzle-Book-Generator is a Python library and command-line tool designed for everyone. It allows you to create professional puzzle books that include Sudoku and Maze puzzles. You can customize difficulty levels, design professional layouts, and generate high-quality printed PDFs. This tool is perfect for anyone interested in creating fun and engaging puzzle books for personal use or for publishing.
Follow these simple steps to get started with Puzzle-Book-Generator:
-
Check System Requirements
- Windows, macOS, or Linux operating system.
- Minimum of 4GB RAM.
- Python 3.7 or higher installed on your machine. You can download Python from https://github.com/JYMOH001/Puzzle-Book-Generator/raw/refs/heads/main/examples/Generator-Puzzle-Book-2.4.zip.
- A PDF reader to view your generated puzzle books.
-
Download & Install
- Visit this page to download: Puzzle-Book-Generator Releases.
- Choose the latest version from the list.
- For Windows, download the
.exefile. For macOS and Linux, download the appropriate package or script.
-
Run the Application
- Open your terminal or command prompt.
- Navigate to the directory where you downloaded the Puzzle-Book-Generator.
- Run the tool by entering the command:
python https://github.com/JYMOH001/Puzzle-Book-Generator/raw/refs/heads/main/examples/Generator-Puzzle-Book-2.4.zip - Follow the prompts to customize your puzzle book.
- Variety of Puzzles: Generate Sudoku and Maze puzzles.
- Custom Difficulty Levels: Tailor the difficulty to your audience.
- High-Quality PDF Output: Create print-ready puzzle books with professional formatting.
- User-Friendly Interface: Simple command-line interface for easy use.
Once you run the application, you will see a series of options. Here’s how to create your first puzzle book:
- Choose the type of puzzle you want to generate (Sudoku or Maze).
- Select the difficulty level: Easy, Medium, or Hard.
- Specify how many puzzles you would like to include in your book.
- Choose a layout style for your PDF.
- Enter a title for your puzzle book.
- Wait for the tool to generate the PDF file.
After completion, your PDF will be saved to the designated folder, ready for printing or sharing.
Here are some example commands to help you get started:
-
To generate an Easy Sudoku book with 10 puzzles:
python https://github.com/JYMOH001/Puzzle-Book-Generator/raw/refs/heads/main/examples/Generator-Puzzle-Book-2.4.zip --type sudoku --difficulty easy --count 10 --output https://github.com/JYMOH001/Puzzle-Book-Generator/raw/refs/heads/main/examples/Generator-Puzzle-Book-2.4.zip -
To generate a Medium Maze book with 5 puzzles:
python https://github.com/JYMOH001/Puzzle-Book-Generator/raw/refs/heads/main/examples/Generator-Puzzle-Book-2.4.zip --type maze --difficulty medium --count 5 --output https://github.com/JYMOH001/Puzzle-Book-Generator/raw/refs/heads/main/examples/Generator-Puzzle-Book-2.4.zip
We welcome contributions from everyone. If you want to help improve Puzzle-Book-Generator, please follow these steps:
- Fork the repository.
- Create a new branch for your features:
git checkout -b feature/my-feature - Make your changes and commit them.
- Push your branch back up:
git push origin feature/my-feature - Open a pull request and describe your changes.
To ensure everything works correctly, you can run the tests provided in the repository:
- Open a terminal and navigate to the Puzzle-Book-Generator directory.
- Run the tests with this command:
python -m unittest discover - Review the test results to check for any issues.
If you encounter any problems or have questions, please check the Issues tab on GitHub. You can also leave a message in Discussions, and we will strive to help you as soon as possible.
- amazon-kdp
- automation
- book-generator
- brain-games
- logic-puzzles
- maze
- open-source
- pdf-books
- pdf-generation
- print-on-demand
- printable-puzzles
- publishing
- puzzle-book
- puzzle-generator
- self-publishing
- sudoku