pixopt¶

A powerful, easy-to-use Python library and CLI tool for optimizing images for web and storage.

![PyPI](https://img.shields.io/pypi/v/pixopt) ![Python](https://img.shields.io/pypi/pyversions/pixopt) ![CI](https://img.shields.io/github/actions/workflow/status/MathiasPaulenko/pixopt/bump-version.yml?label=CI) ![License](https://img.shields.io/github/license/MathiasPaulenko/pixopt)

What is pixopt?¶

pixopt is a fast Python image optimizer designed for modern web workflows. It provides both a rich command-line interface (CLI) and a clean Python API to resize, compress, convert formats, generate responsive assets, extract lazy-loading placeholders, and detect the optimal format automatically.

Whether you are a developer automating image pipelines, a designer preparing assets, or a DevOps engineer optimizing static sites, pixopt handles the heavy lifting so you don't have to.

Highlights¶

🖼️ Format conversion — JPEG, PNG, WEBP, AVIF, GIF, HEIC/HEIF, SVG
🎞️ Animated GIF → WEBP — convert animated GIFs to much lighter animated WEBP
🧹 SVG minification — pure-Python SVG cleanup (no Node.js tools needed)
📱 HEIC/HEIF import — open iPhone photos directly via pillow-heif
🎯 Lossless mode — lossless PNG/WEBP compression for UI assets
🔍 Adaptive quality — binary-search quality to hit a target file size
📊 Visual comparison — interactive HTML before/after slider
📐 Responsive srcset — generate multiple width variants + HTML snippets
🎨 Lazy-loading placeholders — dominant color, LQIP data URI, blurhash
🧠 Smart format detection — auto-select WEBP/JPEG/PNG based on content
💾 Backup originals — copy originals before processing
⚡ Batch processing — single files, directories, or multiple files at once
💻 Beautiful CLI — built with Typer for an intuitive experience

Quick Start¶

CLILibrary

Install and run in one line:

pip install pixopt
pixopt optimize photo.jpg --quality 80 --width 1200

from pixopt import optimize_image
from pixopt.models import OutputFormat

result = optimize_image(
    "photo.jpg",
    "photo_optimized.webp",
    max_width=1200,
    quality=80,
    output_format=OutputFormat.WEBP,
)
print(f"Saved {result.savings_percent:.1f}%")

Next Steps¶

:material-rocket-launch: Installation — Install pixopt on your system
:material-console: CLI Usage — Learn every CLI command with examples
:material-code-braces: Library Usage — Use pixopt programmatically in Python
:material-api: API Reference — Browse the full auto-generated API docs
:material-source-branch: Contributing — Set up your dev environment and contribute

License¶

MIT License — see LICENSE for details.