stampify

Turn black-and-white artwork into stamp-ready STL models.

Repository: https://github.com/nwcell/stampify

Install

Run the CLI without installing:

uvx stampify path/to/image.png

Install it as a standalone tool:

uv tool install stampify
stampify path/to/image.png

Add it to another Python project:

uv add stampify

CLI

Generate the bundled sample stamp:

uv run stampify sample/xmas-cowboy.jpeg

Write to a specific STL path:

uvx stampify path/to/image.png -o stamp.stl

Compare the two geometry modes:

uvx stampify path/to/image.png --mode vector -o stamp-vector.stl
uvx stampify path/to/image.png --mode voxel --resolution 300 -o stamp-voxel.stl

Show all options:

uvx stampify --help

Python API

Use it from Python:

from ink_print import StampOptions, write_stamp

options = StampOptions(mode="vector", size=80, border=2, simplify=0.05)
output_path, mesh = write_stamp("path/to/image.png", options=options)
print(output_path, mesh.extents)

Development

Run from a local checkout:

uv run stampify sample/xmas-cowboy.jpeg

Install the local checkout as a tool:

uv tool install .

Add the local checkout to another project:

uv add git+https://github.com/nwcell/stampify

Notes

• The repo includes sample/xmas-cowboy.jpeg as a sample input.
• vector mode is the default and produces smoother, smaller meshes.
• voxel mode is still available as a fallback.
• --resolution 0 keeps the source image resolution.
• --simplify and --min-area are the main cleanup controls for traced artwork.
• The default stamp mirrors the artwork so the printed impression reads correctly.
• The border is raised by default. Disable it with --no-raised-border.

Release automation

This repo includes:

• .github/workflows/ci.yml for tests and build validation on pushes and pull requests.
• .github/workflows/release.yml for publishing to PyPI from a GitHub Release via Trusted Publishing.

See RELEASING.md for the release process.

License

MIT. See LICENSE.