purepix

A pure-Python, zero-dependency image library — codecs, processing, drawing, and a pile of generative art, all implemented from scratch on top of the standard library. No NumPy, no Pillow, no C extensions.

import purepix
img = purepix.open("photo.jpg")          # auto-detected by magic bytes
small = img.resize((320, 240), purepix.BILINEAR)
purepix.save(small.filter(purepix.filters.SHARPEN), "out.png")

Install

pip install purepix

Requires Python 3.10+. Zero runtime dependencies.

0.3.1 fixes

16-bit PNG transparent-color keys now preserve their full precision. Both purepix.save(img, path, **options) and img.save(path, **options) accept pathlib paths and forward PNG transparency and interlace options. Interlaced PNG writing remains limited to 8-bit images; unsupported options raise errors.

What's inside

Image formats (read/write unless noted)

• BMP, PNG (1/2/4/8/16-bit, Adam7 interlace, tRNS, lossless 16-bit), GIF (incl. animated), PNM (PPM/PGM), TGA (RLE), ICO, farbfeld, WBMP, PCX, XPM
• JPEG — baseline and progressive decode + baseline encode
• QOI — lossless, full round-trip
• TIFF — LE/BE, none / PackBits / LZW / DEFLATE, multi-strip, multi-page
• APNG — animated PNG read/write (offset, blend & dispose ops)
• Compression written from scratch: DEFLATE (dynamic Huffman, greedy + lazy matching), GIF LZW, TIFF LZW, PackBits

Core image ops (Image)

• 8-bit and 16-bit depth, mode conversion, crop, paste, split/merge channels
• resize (nearest / bilinear), flip, rotate (90° and arbitrary angle), affine
• point LUTs, convolution filter

Processing

• filters — blur / gaussian / sharpen / unsharp / median / edge / sobel / emboss, brightness / contrast / gamma / invert / threshold / posterize / solarize, histogram / equalize / autocontrast, ordered dithering
• color — RGB↔HSV, hue/saturation/value, sepia; CIELAB / LCh, ΔE (CIE76 & CIEDE2000), tone curves, vibrance, color temperature, gray-world white balance, levels
• composite — blend modes, alpha compositing, linear/radial gradients
• quantize — median-cut + Floyd–Steinberg dithering
• morphology — erode/dilate/open/close, connected components
• features — Canny edges, Hough lines/circles, Harris corners, contour tracing
• effects — pixelate, vignette, motion blur, cartoon, glitch, oil paint
• seam — content-aware resize (seam carving)
• compare — aHash/dHash/pHash, PSNR, SSIM

Drawing (Draw)

• point, line, wide/anti-aliased line, rectangle, rounded rectangle, ellipse, arc, polygon (scanline fill), Bézier & Catmull-Rom curves, flood fill, and text via a built-in bitmap font

Tools

• qr — QR code generator and decoder (Reed–Solomon encode/decode, masking, format info)
• barcode — Code 128 and EAN-13, encode and decode
• stego — LSB steganography
• exif — JPEG EXIF / PNG text metadata, auto-orient
• dft — 2-D DFT: spectrum + low/high-pass filtering
• ascii_art — render images to ASCII / ANSI

Generative art & simulation

• fractal (Mandelbrot/Julia), noise (Perlin/fBm, clouds, marble), lsystem, reaction (Gray-Scott), automata (Life + elementary CA), maze, wfc, raytrace, plasma/fire, dla, voronoi/stippling, flowfield, sortviz, astar

Command line

python -m purepix info photo.png
python -m purepix convert in.png out.jpg --quality 90
python -m purepix resize in.png out.png --size 320x240
python -m purepix qr "https://example.com" qr.png
python -m purepix hash photo.png --type phash

Example

import purepix
from purepix import Draw, fractal, qr

# generate a fractal
fractal.mandelbrot((400, 300), max_iter=150).save("mandelbrot.png")

# draw with the built-in font
img = purepix.Image.new("RGB", (200, 60), (20, 20, 30))
Draw(img).text((10, 20), "PUREPIX", (0, 255, 180), scale=3)
img.save("banner.png")

# make a QR code
qr.encode("hello world", ec="M").save("qr.png")

License

MIT © Equinox