phomo

API—OSS—FREEyesDOCS4/5
PH5.8#7 of 23
—WeboutWindowsoutMacoutLinux—Android—iOS

Ranked in Photo Mosaic Software ·Free plan

About

phomo is a free tool for creating photographic mosaics by arranging tile images to recreate a master image. It compares color distributions between tiles and regions of the master, then assigns tiles using a linear sum assignment algorithm. The project can be installed with pip as a Python package, and its `phomo` command accepts a master image and a directory of tile images. CLI controls include cropping and resizing the master and tiles, black-and-white conversion, grid display, and tile appearance count. Matching options include greyscale, norm, and luv_approx distance metrics, color equalization, and color-distribution matching. A greedy assignment option can improve performance at the cost of accuracy. GPU acceleration is available through a CUDA extra and requires a CUDA-compatible GPU and CUDA toolkit. The package requires Python >=3.9 and <3.13, runs on Linux, macOS, and Windows, and lists PNG as an output format. The project is published under the MIT License.

Who it is for

phomo suits developers or image-makers who want to build photographic mosaics from a tile library using Python or a command-line workflow. It can also fit environments that have a compatible CUDA setup for GPU acceleration.

What is good

  • Installable with pip and usable as a Python package.
  • CLI accepts a master image and tile directory.
  • Offers several distance metrics and color controls.
  • Published under the MIT License.
  • Runs on Linux, macOS, and Windows.

What to know first

  • Requires Python >=3.9 and <3.13.
  • CUDA acceleration requires a compatible GPU and toolkit.
  • Greedy assignment trades accuracy for performance.

Verdict

phomo gives Python users configurable mosaic matching with both package and CLI access. Check the Python version requirement and CUDA prerequisites if GPU acceleration matters.

Compared on photo mosaic software

Free plan
Yesgithub.com
Platform
desktopgithub.com
Custom tile library
Yesgithub.com
Tile reuse controls
Yesgithub.com
Output formats
PNGgithub.com

Facts

Purpose
phomo creates photographic mosaics by arranging tile images to recreate a master image.github.com · 3 Oct 2026
Tile matching
It compares tile images with master image regions using color distribution differences, then assigns tiles to regions with a linear sum assignment algorithm.github.com · 3 Oct 2026
Python package
The project can be installed with pip and used as a Python package.github.com · 3 Oct 2026
Command line
The package provides a `phomo` command that accepts a master image and a directory of tile images.github.com · 3 Oct 2026
GPU support
GPU acceleration is available through the CUDA extra and requires a CUDA-compatible GPU and CUDA toolkit.github.com · 3 Oct 2026
Image controls
CLI options include cropping and resizing the master and tile images, black-and-white conversion, grid display, and tile appearance count.github.com · 3 Oct 2026
Matching options
The CLI offers greyscale, norm, and luv_approx distance metrics, color equalization, and options to match color distributions.github.com · 3 Oct 2026
Performance option
A greedy tile assignment option is described as improving performance at the expense of accuracy.github.com · 3 Oct 2026
Platforms
PyPI lists macOS, Windows, and Linux operating system classifiers for the package.pypi.org · 3 Oct 2026
Python versions
PyPI states that the package requires Python >=3.9 and <3.13.pypi.org · 3 Oct 2026
License
The project is published under the MIT License.github.com · 3 Oct 2026
Maintainer
PyPI identifies Loic Coyle as the author and lists one maintainer.pypi.org · 3 Oct 2026

Best phomo alternatives

See all 20

Where it ranks on Inferse

Sources