Raygin — Python Game Engine for Raylib

---

🛠️ Requirements

• Python 3.11+ (3.11 to 3.14.9)
• Poetry (for dependency management)
• Raylib (via Python bindings)

⚠️ Note: This project uses a custom implementation of Raylib in Python. The raylib package in this project is a wrapper around the C-based Raylib library.

---

🚀 Installation

1. Install Poetry (if you don't have it yet):

   pip install poetry

2. Create a virtual environment (optional but recommended):

   python -m venv venv
   source venv/bin/activate  # Linux/macOS
   venv\Scripts\activate     # Windows

3. Install dependencies:

   poetry install

4. Run your game:

   poetry run python main.py

---

📦 Building for Distribution

To package your game into a single executable file (for distribution):

1. Install PyInstaller (via Poetry):

   poetry install --dev

2. Build the executable:

   poetry run build

This will generate a dist folder with your game executable. The built executable supports:

• Windows (x64)
• macOS (x64)
• Linux (x64)

💡 Tip: The build command uses PyInstaller v6.16.0+ for optimal performance.

---

📚 Documentation

• Raylib Official Documentation

---

📌 Notes

• The raylib package in this project is a custom wrapper for the C-based Raylib library.
• This implementation is designed for 2D games only.

---

Raygin v0.0.1 | GitHub | Poetry