stitching
github.com
What it is
stitching is a free Python package for making panoramas from image files or images already loaded in a program. It is based on OpenCV’s stitching module and can be used through a command-line interface or from Python scripts. The CLI can process JPG files in a directory, images selected with a wildcard, or explicitly named files; the Python API provides Stitcher and AffineStitcher classes. Stitcher accepts custom settings, and AffineStitcher corresponds to the CLI’s affine option. For troubleshooting, verbose mode saves intermediate results, while supplied utilities and a Jupyter Notebook tutorial help inspect RANSAC matches and blended seam lines. The package can be installed with pip or run from the openstitching/stitch Docker image. In Docker, images are read from a mounted /data directory and the default output is result.jpg in that directory. The project recommends stitching-headless for server and cloud environments. It is Python 3 only and distributed under the Apache License 2.0. PyPI lists version 0.7.0, released September 5, 2026.
Spec sheet
- Purpose
- Stitching is a Python package for fast and robust image stitching.Read 9 Oct 2026 · github.com
- Integrations
- The project is based on OpenCV and provides a Docker image named openstitching/stitch.Read 4 Oct 2026 · github.com
- Support
- The project directs questions to GitHub Discussions and asks users not to use the issue section for questions.Read 9 Oct 2026 · github.com
- License
- The repository is licensed under Apache License 2.0.Read 9 Oct 2026 · github.com
- Affine mode
- The package provides an AffineStitcher class corresponding to the CLI’s --affine parameter.Read 9 Oct 2026 · github.com
- Analysis tutorial
- The project provides utility functions and a Jupyter Notebook tutorial for analyzing stitching, including RANSAC matches and blended seam lines.Read 9 Oct 2026 · github.com
- CLI
- The installed command-line interface can stitch matching files in a directory or explicitly named images.Read 9 Oct 2026 · github.com
- Command line
- Its CLI can stitch all JPG files in a directory, files matched by a wildcard, or explicitly listed images.Read 4 Oct 2026 · github.com
- Configuration
- The Stitcher accepts custom settings, with detector and confidence_threshold shown as examples.Read 9 Oct 2026 · github.com
- Debugging
- Verbose mode saves intermediate results, and the package includes utilities for examining stitching, including RANSAC matches and seam lines.Read 4 Oct 2026 · github.com
- Diagnostics
- Verbose mode stores intermediate results to help investigate image stitching problems.Read 9 Oct 2026 · github.com
- Distribution
- The package can be installed with pip or run using the project’s Docker image.Read 9 Oct 2026 · github.com
- Docker behavior
- The Docker image reads images from a mounted /data directory and stores its default result there as result.jpg.Read 9 Oct 2026 · hub.docker.com
- Headless use
- The README recommends installing stitching-headless for server environments such as Docker and cloud environments.Read 9 Oct 2026 · github.com
- Install options
- The maker documents installation with pip and provides a Docker image; it recommends stitching-headless for server environments such as Docker and cloud environments.Read 4 Oct 2026 · github.com
- Intended use
- The package was developed and used for a research paper about automatic stitching of fragmented construction plans of hydraulic structures.Read 4 Oct 2026 · github.com
- Latest release
- PyPI lists version 0.7.0, released September 5, 2026.Read 4 Oct 2026 · pypi.org
- Output
- The package creates panoramas from image files or already loaded images.Read 4 Oct 2026 · github.com
- Package compatibility
- PyPI classifies the package as Python 3 only and lists a universal py3-none-any wheel.Read 4 Oct 2026 · pypi.org
- Python API
- The Stitcher class can create panoramas from filenames, wildcard patterns, or already loaded images.Read 9 Oct 2026 · github.com
- Python use
- The package exposes Stitcher and AffineStitcher classes for use in Python scripts.Read 4 Oct 2026 · github.com
- Research use
- The package was developed and used for a paper about automatically stitching fragmented construction plans of hydraulic structures.Read 9 Oct 2026 · github.com
- Underlying technology
- The package is based on OpenCV’s stitching module and inspired by its stitching_detailed.py command-line tool.Read 9 Oct 2026 · github.com
Plans and prices
Strong points and limits
Strong points
- Creates panoramas from files or loaded images.
- Offers both Python classes and a command-line interface.
- Verbose mode saves intermediate results for investigation.
- Docker image and pip installation are documented.
- Apache License 2.0.
Limits
- Python 3 only.
- Maker recommends a separate headless package for server and cloud environments.
- Questions are directed to GitHub Discussions, not the issue section.
Who it suits
This package suits Python users who want to create panoramas from files or in-memory images, and developers who need CLI or Docker options. Its diagnostics may help people investigating stitching results.
Verdict
stitching provides multiple ways to assemble images into panoramas and inspect intermediate results. Its documented routes include Python, CLI, and Docker, with a Python 3-only compatibility scope.
Where Specifiction places it
- Panorama Stitching Software#8 of 238.0