gen-art-framework 0.3.0

A framework for creating generative art with Python

gen-art-framework

A Python framework for generating art from parameterised scripts. Define parameter distributions in YAML, and the framework samples from them to create unique variations of your artwork.

Installation

pip install gen-art-framework

Or with uv:

uv add gen-art-framework

Quick Start

Create a script with a YAML parameter block in its docstring:

"""
parameters:
  - name: seed
    distribution: constant
    value: 42
  - name: width
    distribution: constant
    value: 800
  - name: height
    distribution: constant
    value: 600
  - name: num_circles
    distribution: randint
    low: 20
    high: 50
  - name: colour
    distribution: choice
    values: ["#e94560", "#f39c12", "#00b894"]
"""

from PIL import Image, ImageDraw
import random

random.seed(seed)

img = Image.new("RGB", (width, height), "#1a1a2e")
draw = ImageDraw.Draw(img)

for _ in range(num_circles):
    x = random.randint(0, width)
    y = random.randint(0, height)
    r = random.randint(10, 50)
    draw.ellipse([x - r, y - r, x + r, y + r], fill=colour)

img

Generate images using the CLI:

# Generate a single image
gen-art sample my_script.py

# Generate 10 variations
gen-art sample my_script.py --count 10

# Specify output directory and seed for reproducibility
gen-art sample my_script.py -n 5 -o ./output -s 42

Output files are named {script_name}_{index}_{seed}.png.

Contributing

Development Workflow

1. Create a PR with your changes
2. CI will run tests, linting, and formatting checks
3. Once approved and merged to main, your changes are in the codebase
4. When ready to release, create and push a version tag:

   git tag v0.1.3        # Use semantic versioning: vMAJOR.MINOR.PATCH
   git push origin v0.1.3
   

5. The tag push automatically triggers a build and publishes to PyPI

Version numbering:

• patch (v0.1.1 → v0.1.2) for bug fixes
• minor (v0.1.1 → v0.2.0) for new features
• major (v0.1.1 → v1.0.0) for breaking changes

CI checks:

• Tests must pass
• No linting errors
• Code must be properly formatted

Run checks locally:

• just test - run tests
• just lint - check linting
• just fmt - format code
• just check - format and lint together

Documentation

• CLI Usage - Command-line interface reference
• Writing Scripts - How to write parameterised art scripts
• Distributions - Available parameter distributions
• Python API - Programmatic usage
• Examples - Walkthrough of example scripts