Python toolkit for programmatic figure design.
- Easily convert images to different formats
- Stitch keynote / powerpoint slides into auto-cropped images
- Stitch multiple figures to a single PDF
- Scrape images from publication PDFs / websites
- Download stock images from Unsplash / Pixabay
- Batch-generate images from prompts in a single line
- Make image grids, decks, and icons (e.g. hexicons)
Basic installation from PyPI:
pip install figwizzWith optional dependencies:
# For AI image generation
pip install 'figwizz[genai]'
# For PDF processing
pip install 'figwizz[pdf]'
# For SVG support
pip install 'figwizz[svg]'
# For development
pip install 'figwizz[dev]'
# For documentation
pip install 'figwizz[docs]'
# Install all optional dependencies
pip install 'figwizz[genai,pdf,svg]'from figwizz import convert_image
# Convert image format
convert_image("input.png", "jpg")
# Convert with custom settings
convert_image("input.png", "pdf", delete_original=False)from figwizz import make_image_opaque, ngon_crop
# Make transparent image opaque
make_image_opaque("logo.png", bg_color="white")
# Create hexagonal crop
ngon_crop("photo.jpg", sides=6, crop_size=512)from figwizz import slides_to_images, images_to_pdf
# Convert PowerPoint/Keynote to images
slides_to_images("presentation.pptx", output_dir="slides/")
# Stitch images into PDF
images_to_pdf("slides/", output_path="presentation.pdf")from figwizz import download_stock_images
# Download from Unsplash or Pixabay
download_stock_images(
query="nature landscape",
n_images=10,
output_dir="stock_images/",
source="unsplash" # or "pixabay"
)from figwizz import generate_images
# Generate images from prompts
generate_images(
prompts=["a serene mountain lake", "abstract geometric art"],
model="gpt-image-1",
output_dir="generated/"
)from figwizz import make_image_grid
# Create and display image grid
images = ["img1.jpg", "img2.jpg", "img3.jpg", "img4.jpg"]
titles = ["Sample 1", "Sample 2", "Sample 3", "Sample 4"]
make_image_grid(images, titles=titles, max_cols=2)from figwizz.workflows import make_hexicon
# Create hexagonal icon
hexicon = make_hexicon(
"logo.png",
size=512,
border_thickness=10,
border_color="auto"
)
hexicon.save("hexicon.png")# Download stock images
figwizz download-stock "mountain landscape" --n-images 5 --source unsplash
# Generate AI images
figwizz generate "abstract art" --model dall-e-3 --n-images 3
# Convert presentation to images
figwizz slides-to-images presentation.pptx --output-dir slides/
# Extract images from PDF or URL
figwizz extract-images document.pdf --output-dir extracted/
figwizz extract-images https://example.com/page --output-dir scraped/Full documentation available at: https://colinconwell.github.io/FigWizz
For API-based features, set up a .env.local file:
# For stock image downloads
UNSPLASH_ACCESS_KEY=your_unsplash_key
PIXABAY_API_KEY=your_pixabay_key
# For AI image generation
OPENAI_API_KEY=your_openai_key