micompress

Compress images, PDFs, video, audio, documents & archives from your terminal or Python. Powered by micompress.com.

A tiny zero-dependency client (standard library only) that sends your file to the MiCompress engine and writes back the optimized result.

pip install micompress

CLI usage

micompress photo.jpg                 # → photo-min.jpg
micompress *.png --preset extreme
micompress report.pdf slides.pptx -o out/
micompress big.jpg --max-width 1920 --json

API key

Small files work without an account. For bigger files and a monthly allowance, use your personal API key (mc_…), shown on your account page — creating an account is free.

export MICOMPRESS_API_KEY=mc_your_key_here
micompress big-video.mp4
# or per command (the flag wins over the environment variable)
micompress big-video.mp4 --api-key mc_your_key_here

When the allowance is used up the CLI reports API_QUOTA_REACHED (free) or USAGE_LIMIT_REACHED (paid). See micompress.com/plans. Keep the key secret — anyone who has it can spend your quota.

Python API

from micompress import compress_file

data, meta = compress_file("photo.jpg", preset="extreme")
open("photo-min.jpg", "wb").write(data)
print(meta["savedPercent"], "% smaller")

# With an API key (sent as the X-API-Key header)
data, meta = compress_file("big.pdf", api_key="mc_your_key_here")

Supported formats

Image (jpg, png, webp, gif, tiff, avif, svg, heic, psd, raw…), PDF & Office docs, video (mp4, mov, mkv, webm…), audio (mp3, wav, flac…), archives (zip, 7z, tar, gz). Full list: https://micompress.com/all-tools

Requirements

Python 3.8+. No third-party dependencies.

License

MIT © MiCompress

_{Prefer a web UI or bigger batches? Use micompress.com.}