SeamOp

seamop is a Python library and command-line tool for content-aware image resizing. It shrinks images by removing connected paths of low-energy pixels instead of scaling every pixel or cropping a fixed region.

Original (1428 × 968)	Resized (1000 × 900)

The current beta supports shrinking by seam removal. Enlargement and seam insertion are not implemented.

Installation

Install from PyPI:

python -m pip install seamop

For development, use the locked uv environment:

uv sync --extra dev --frozen

Command line

Resize the smaller example to 400 by 240 pixels:

seamop resize examples/medium.jpg 400 240

This writes medium_resized_400x240.jpg in the current directory. Use --output to choose another path. Existing image outputs are not overwritten.

Preview the pixels that the same resize would remove:

seamop highlight examples/medium.jpg 400 240

Remove ten vertical seams:

seamop remove examples/medium.jpg --direction vertical --count 10

Other commands and options are available through the built-in help:

seamop --help
seamop resize --help
seamop remove --help
seamop highlight --help

CLI dimensions use WIDTH HEIGHT.

Python

resize() accepts a filesystem path, Pillow image, RGB uint8 NumPy array, or nested RGB integer list. It returns a new RGB uint8 NumPy array without mutating the input.

from PIL import Image
import seamop

result = seamop.resize(
    "examples/medium.jpg",
    width=400,
    height=240,
)

Image.fromarray(result).save("medium_resized_400x240.jpg")

Use plan() when the carved result and preview must use the same seam decisions:

resize_plan = seamop.plan(
    "examples/medium.jpg",
    width=400,
    height=240,
)

preview = resize_plan.preview()
result = resize_plan.result()

Both output methods return independent arrays. Calling either method does not change the plan.

See the Python API guide for input rules, custom energy methods, errors, and the advanced seam-calculation interface.

Documentation

Development

Run the repository checks from the project root:

uv run --frozen ruff check src tests benchmarks
uv run --frozen ruff format --check src tests benchmarks
uv run --frozen mypy
uv run --frozen pytest --cov
uv run --frozen pytest --doctest-modules src/seamop

Benchmarks run separately:

uv run --frozen pytest benchmarks

Limitations

Only shrinking is supported.
Width is reduced before height when both dimensions change.
Results depend on the image and selected energy method.
Large reductions can distort important content.

License

MIT

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

seamop-0.1.4.tar.gz (33.3 kB view details)

Uploaded Aug 4, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

seamop-0.1.4-py3-none-any.whl (19.3 kB view details)

Uploaded Aug 4, 2026 Python 3

File details

Details for the file seamop-0.1.4.tar.gz.

File metadata

Download URL: seamop-0.1.4.tar.gz
Upload date: Aug 4, 2026
Size: 33.3 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for seamop-0.1.4.tar.gz
Algorithm	Hash digest
SHA256	`05033e263ddc385cf1c265f4df629f4df3057c1321fb04fa0db069fe8c3d2f52`
MD5	`fdc0990f1531b30cb4d71007fb743e28`
BLAKE2b-256	`74519ebbd6fdf04e1ac25394c756614487af910a7bf5ee72bae33f5c226f3e0d`

See more details on using hashes here.

Provenance

The following attestation bundles were made for seamop-0.1.4.tar.gz:

Publisher: release.yml on okinealb/seamop

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: seamop-0.1.4.tar.gz
- Subject digest: 05033e263ddc385cf1c265f4df629f4df3057c1321fb04fa0db069fe8c3d2f52
- Sigstore transparency entry: 2341222431
- Sigstore integration time: Aug 4, 2026
Source repository:
- Permalink: okinealb/seamop@23be2ca195e331b31e6f8da7ea6a9d041755b43f
- Branch / Tag: refs/tags/v0.1.4
- Owner: https://github.com/okinealb
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@23be2ca195e331b31e6f8da7ea6a9d041755b43f
- Trigger Event: push