Skip to main content

ImageHash

A image hashing library written in Python. ImageHash supports:

  • average hashing (aHash)

  • perception hashing (pHash)

  • difference hashing (dHash)

  • wavelet hashing (wHash)

Travis Coveralls

Rationale

Why can’t we use md5, sha-1, etc.?

Unfortunately, we cannot use cryptographic hashing algorithms in our implementation. Due to the nature of cryptographic hashing algorithms, very tiny changes in the input file will result in a substantially different hash. In the case of image fingerprinting, we actually want our similar inputs to have similar output hashes as well.

Requirements

Based on PIL/Pillow Image, numpy and scipy.fftpack (for pHash) Easy installation through pypi.

Basic usage

>>> from PIL import Image
>>> import imagehash
>>> hash = imagehash.average_hash(Image.open('test.png'))
>>> print(hash)
d879f8f89b1bbf
>>> otherhash = imagehash.average_hash(Image.open('other.bmp'))
>>> print(otherhash)
ffff3720200ffff
>>> print(hash == otherhash)
False
>>> print(hash - otherhash)
36

The demo script find_similar_images illustrates how to find similar images in a directory.

Source hosted at github: https://github.com/JohannesBuchner/imagehash

Changelog

  • 3.5: image data handling speed-up

  • 3.2: whash now also handles smaller-than-hash images

  • 3.0: dhash had a bug: It computed pixel differences vertically, not horizontally.

    I modified it to follow dHash. The old function is available as dhash_vertical.

  • 2.0: added whash

  • 1.0: initial ahash, dhash, phash implementations.

Metadata

Release files for ImageHash 3.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ImageHash 3.5
File Size Uploaded Provenance Actions
ImageHash-3.5.tar.gz 294.6 kB Without provenance Details for ImageHash-3.5.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for ImageHash 3.5
File Interpreter ABI Platform Actions
ImageHash-3.5-py2.7.egg Legacy Egg format - - Details for ImageHash-3.5-py2.7.egg

Total release size: 595.2 kB

Release files / ImageHash-3.5.tar.gz

Download URL ImageHash-3.5.tar.gz
Size 294.6 kB
Tags Source
SHA-256 checksum
How to use checksums
5b78812a78109b7cfdc0c4d92b15a24416d8af27e3f915db1b83f074dc5ec912
BLAKE2b-256 checksum
How to use checksums
4f2b39e13c004a745a130da64a07940c277320687cd3d3534f6b5fabac5ef6ae
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / ImageHash-3.5-py2.7.egg

Download URL ImageHash-3.5-py2.7.egg
Size 300.6 kB
Tags Egg
SHA-256 checksum
How to use checksums
959248dc766acce97a4ee18300ce4c56bf49b55b8ad16efb09c30c44abf60456
BLAKE2b-256 checksum
How to use checksums
0660d840f929be0e7b9b1d771c552ddd81046b57725b2cedbf03036ec55239ac
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Security for ImageHash 3.5

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page