- Home
- Panorama Stitching Software
- stitching
stitching
What it is
stitching is a free Python package for creating panoramas from image files or images already loaded in a program. Built on OpenCV’s stitching module, it provides a command-line interface and Python classes for image stitching. The CLI can process JPG files in a directory, files selected by a wildcard, or explicitly named images. Python scripts can use the Stitcher and AffineStitcher classes, and the Stitcher accepts custom settings such as detector and confidence threshold. Verbose mode saves intermediate results for investigation, while included utilities and a Jupyter Notebook tutorial can help examine stitching details such as RANSAC matches and blended seam lines. The package can be installed with pip or run using the project’s Docker image; the maker recommends stitching-headless for server and cloud environments. Its Docker image reads from a mounted /data directory and saves its default result there as result.jpg. The package is for Python 3 and is distributed under the Apache License 2.0. The project was developed and used for research on automatically joining fragmented construction plans of hydraulic structures. Questions are directed to GitHub Discussions rather than the issue section.
For and against
For
- Free package distributed under Apache License 2.0.
- Offers both a CLI and Python classes.
- Can use filenames, wildcards, or loaded images.
- Verbose mode saves intermediate results.
- Docker image supports mounted input and output directories.
Against
- Package is for Python 3 only.
- Maker recommends a separate headless package for server environments.
- Questions go to GitHub Discussions, not the issue section.
The verdict
stitching offers several ways to create panoramas and inspect intermediate stitching results, including a Docker workflow. Python users should note its Python 3 classification and the maker’s recommendation to use stitching-headless for server environments.
Who it suits
stitching suits Python users who need to create panoramas from image files and want command-line or script-based workflows. Its headless and Docker options may suit server or cloud environments.
Plans and prices
Free / open source
Python package · CLI · Docker image · Apache-2.0 license
Read 9 Oct 2026 · github.com
On the record
- Affine mode
- The package provides an AffineStitcher class corresponding to the CLI’s --affine parameter.github.com · read 9 Oct 2026
- Analysis tutorial
- The project provides utility functions and a Jupyter Notebook tutorial for analyzing stitching, including RANSAC matches and blended seam lines.github.com · read 9 Oct 2026
- CLI
- The installed command-line interface can stitch matching files in a directory or explicitly named images.github.com · read 9 Oct 2026
- Command line
- Its CLI can stitch all JPG files in a directory, files matched by a wildcard, or explicitly listed images.github.com · read 4 Oct 2026
- Configuration
- The Stitcher accepts custom settings, with detector and confidence_threshold shown as examples.github.com · read 9 Oct 2026
- Debugging
- Verbose mode saves intermediate results, and the package includes utilities for examining stitching, including RANSAC matches and seam lines.github.com · read 4 Oct 2026
- Diagnostics
- Verbose mode stores intermediate results to help investigate image stitching problems.github.com · read 9 Oct 2026
- Distribution
- The package can be installed with pip or run using the project’s Docker image.github.com · read 9 Oct 2026
- Docker behavior
- The Docker image reads images from a mounted /data directory and stores its default result there as result.jpg.hub.docker.com · read 9 Oct 2026
- Headless use
- The README recommends installing stitching-headless for server environments such as Docker and cloud environments.github.com · read 9 Oct 2026
- 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.github.com · read 4 Oct 2026
- Integrations
- The project is based on OpenCV and provides a Docker image named openstitching/stitch.github.com · read 4 Oct 2026
- Intended use
- The package was developed and used for a research paper about automatic stitching of fragmented construction plans of hydraulic structures.github.com · read 4 Oct 2026
- Latest release
- PyPI lists version 0.7.0, released September 5, 2026.pypi.org · read 4 Oct 2026
- License
- The repository is licensed under Apache License 2.0.github.com · read 9 Oct 2026
- Output
- The package creates panoramas from image files or already loaded images.github.com · read 4 Oct 2026
- Package compatibility
- PyPI classifies the package as Python 3 only and lists a universal py3-none-any wheel.pypi.org · read 4 Oct 2026
- Purpose
- Stitching is a Python package for fast and robust image stitching.github.com · read 9 Oct 2026