Skip to content

Interactive Mandelbrot fractal explorer written in Python. Powered by CUDA-accelerated rendering and a PySide6 GUI, MandelPy lets you zoom smoothly, tweak quality and iteration limits, and design custom colour gradients with a built-in editor & preset manager—all in real time.

License

Notifications You must be signed in to change notification settings

Neckername/MandelPy-WIP

Documentation:

project-image

Project Screenshots:

project-screenshot

🧐 Features

Here're some of the project's best features:

  • ⚡ GPU acceleration – Numba‐CUDA kernel renders millions of pixels/iteration on the GPU; >100 FPS is common on mid-range cards.
  • 🖱️ Smooth navigation – scroll-wheel zoom click-and-drag pan quick reset plus numeric controls for exact coordinates & magnification.
  • 🎨 Gradient editor – add / remove colour stops drag to reorder sample colours preview in real time and save/load JSON “.grd” presets.
  • 🗺️ Focal map – thumbnail of the full set with a cross-hair showing your current viewport; great for never losing your bearings.
  • 💾 Quick-save / Save-as – export high-resolution PNG snapshots of the current view or store (.json) sessions containing viewport + gradient.
  • ⚙️ Preferences dialog – pick default quality output folder UI scale … persisted in a tiny JSON file in your user config directory.
  • 📦 Zero C/C++ build steps – pure Python + wheels from PyPI.

🛠️ Installation Steps:

1. Create a virtual environment (optional but recommended)

python -m venv venv

2. Activate virtual environment (skip to step 4 if running without venv)

source venv/bin/activate

3. To activate on Windows

source venv\Scripts\activate

4. Install dependencies

pip install -r requirements.txt

5. Run MandelPy

python main.py

🍰 Contribution Guidelines:

Refer to CONTRIBUTING.md and our CODE_OF_CONDUCT.md for more info.

🛡️ License:

This project is licensed under the MandelPy is released under the MIT License – see MIT License.

About

Interactive Mandelbrot fractal explorer written in Python. Powered by CUDA-accelerated rendering and a PySide6 GUI, MandelPy lets you zoom smoothly, tweak quality and iteration limits, and design custom colour gradients with a built-in editor & preset manager—all in real time.

Topics

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Packages

No packages published

Languages