Pixelmatch Image Comparison Library

---
name: "Pixelmatch Pixel-Level Image Comparison Library by Mapbox"
slug: "pixelmatch-image-comparison-library"
description: "Pixelmatch is the smallest, simplest, and fastest JavaScript pixel-level image comparison library by Mapbox. It features anti-aliased pixel detection and perceptual color difference metrics, making it ideal for visual regression testing in CI/CD pipelines."
github_stars: 6786
verification: "security_reviewed"
source: "https://github.com/mapbox/pixelmatch"
category: "Image & Creative Automation"
framework: "Multi-Framework"
tool_ecosystem:
  github_repo: "mapbox/pixelmatch"
  github_stars: 6786
  npm_package: "pixelmatch"
  npm_weekly_downloads: 8712992
---

# Pixelmatch Pixel-Level Image Comparison Library by Mapbox

Pixelmatch is the smallest, simplest, and fastest JavaScript pixel-level image comparison library by Mapbox. It features anti-aliased pixel detection and perceptual color difference metrics, making it ideal for visual regression testing in CI/CD pipelines.

## Installation

Use the upstream install or setup path that matches your environment:
- npm install pixelmatch

Requirements and caveats from upstream:
- [![Node](https://github.com/mapbox/pixelmatch/actions/workflows/node.yml/badge.svg)](https://github.com/mapbox/pixelmatch/actions/workflows/node.yml)
- so it's **blazing fast** and can be used in **any environment** (Node or browsers).
- ### Node.js

Basic usage or getting-started notes:
- ## Example output
- ## Example usage
- bash

- Source: https://github.com/mapbox/pixelmatch
- Extracted from upstream docs: https://raw.githubusercontent.com/mapbox/pixelmatch/HEAD/README.md

## Source

- [Agent Skill Exchange](https://agentskillexchange.com/skills/pixelmatch-image-comparison-library/)