PyFreeform¶

Turn images into art with Python.

Three Lines of Code, Infinite Possibilities¶

Parametric shapes

from pyfreeform import Scene

scene = Scene.from_image("photo.jpg", grid_size=40)
for cell in scene.grid:
    cell.add_dot(radius=cell.brightness * 0.4, color=cell.color)
scene.save("artwork.svg")

Choose Your Path¶

Getting Started

Install PyFreeform and create your first artwork in minutes.

Get started →
Guide

Learn every feature through progressive, visual examples.

Start learning →
Recipes

Build complete projects: portraits, patterns, typography, and more.

Browse recipes →
API Surface

Comprehensive reference for every class, method, and parameter.

Explore the API →

Install¶

pip install pyfreeform

Requires Python 3.10+ and Pillow (installed automatically).