Skip to content

Getting Started

m4bwav edited this page Nov 14, 2026 · 2 revisions

Install

As a Claude Code plugin:

claude plugin marketplace add m4bwav/fractalwright
claude plugin install fractalwright@fractalwright

Other agents can read skills/fractalwright/SKILL.md and run scripts/fw.py from a clone.

Needs

Python 3.9 or later and NumPy. Pillow is optional and lets measure read image files. Without NumPy a slow pure Python fallback renders small pictures. ffmpeg is needed for video and audio. Playwright with Edge or Chrome is needed for the explorer's browser route and for 3D. moderngl is reported by doctor but not used yet.

Check the setup

python scripts/fw.py doctor

It prints one line per dependency: the version found, or missing, and what it is for.

First render

python scripts/fw.py render seahorse -o seahorse.png --size 640x360
wrote seahorse.png and seahorse.json

seahorse.json is the recipe. Render it again and you get the same pixels; see Recipe format.

Next

Commands covers stills and measuring; Video and audio, Explorer, Generative and Neighbours and 3D cover the rest.

Clone this wiki locally