blurhash
Pure-Python implementation of the blurhash algorithm.
Decision gist · record as of 2026-08-14
Yes. The package is stable (Production/Stable status), has zero known vulnerabilities, installs with no dependencies, and solves a specific problem well for image-heavy applications. The aging maintenance status is not a blocker—the library is mature and the repository remains active. Install it if you need image placeholders or compact image representations.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires a 3-dimensional array with y, x, and RGB components; encoding and decoding require external libraries like PIL and numpy to prepare image data.
- Installs with no runtime dependencies and low friction.
- Last release was 362 days ago; the repository is active and not archived, though maintenance status is aging.
License · maintenance · safety
MIT (permissive) — MIT license (permissive) — you can use, modify, and distribute this package freely in commercial and private projects with minimal restrictions.
last release 2025-08-17 (362 days) · last repo commit 2025-08-17 · 97 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 225,565 downloads/mo, #9,219 on PyPI
Alternatives
Verify before relying
pip install blurhash
import blurhash
# Encode and decode blurhash strings
hash_string = blurhash.encode(image_array)
img_array = blurhash.decode(hash_string, 128, 128)- Whether the aging maintenance status indicates future support concerns or is simply a stable, mature library.
- Performance characteristics when encoding or decoding very large images or many images in sequence.
- Python version compatibility beyond the classifiers indicating support for Python 2 and 3.
What it is and what it does
Blurhash is a pure-Python implementation of the blurhash algorithm that converts images into short text strings representing blurred versions of those images. The library exports encode and decode functions to transform between image arrays and blurhash strings, plus helper functions for color space conversion between sRGB and linear color. It has no runtime dependencies, making it lightweight to add to any project.
The typical use case is generating placeholder images during page load: you encode an image once and store the small hash string alongside your image metadata, then decode it to quickly display a blurred preview while the full image loads or before showing it behind a content warning. The decode function accepts a punch parameter to adjust contrast and can decode to any specified width and height.
Use it for
- Generate blurred placeholder images for web pages while full-resolution images are loading.
- Store compact image previews in metadata or databases without storing full image files.
- Create content-warning blur overlays by decoding blurhash strings to small placeholder images.
- Embed blurhash strings in JSON responses to provide instant visual feedback before image delivery.
- Resize and blur images efficiently by encoding once and decoding to different dimensions.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
The package is stable (Production/Stable status), has zero known vulnerabilities, installs with no dependencies, and solves a specific problem well for image-heavy applications. The aging maintenance status is not a blocker—the library is mature and the repository remains active. Install it if you need image placeholders or compact image representations.
Install
blurhash on PyPI
Before you install
Installs with no runtime dependencies and low friction. Last release was 362 days ago; the repository is active and not archived, though maintenance status is aging.
Requires a 3-dimensional array with y, x, and RGB components; encoding and decoding require external libraries like PIL and numpy to prepare image data.
License in practice
MIT license (permissive) — you can use, modify, and distribute this package freely in commercial and private projects with minimal restrictions.
Quickstart
pip install blurhash
import blurhash
# Encode and decode blurhash strings
hash_string = blurhash.encode(image_array)
img_array = blurhash.decode(hash_string, 128, 128)Verify before relying
- Whether the aging maintenance status indicates future support concerns or is simply a stable, mature library.
- Performance characteristics when encoding or decoding very large images or many images in sequence.
- Python version compatibility beyond the classifiers indicating support for Python 2 and 3.
Package facts
| License | MIT permissive |
| Python support | Not specified |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | None |
| Maintenance | Aging 362 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 225,565 / month, #9,219 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableIntended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseProgramming Language :: Python :: 2Programming Language :: Python :: 3Topic :: Multimedia :: Graphics |
Evidence: blurhash-1.1.5-py2.py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “image placeholder generation”
- blurhashEncodes images into compact blurhash text strings and decodes them…
- blurhash-pythonEncodes images into BlurHash strings, compact perceptual hashes that…
- sorl-thumbnailGenerates and caches image thumbnails for Django applications, with…
Give your agent the search over MCP, or paste the wish link into any chat.
More Graphics packages
Pillow adds image processing capabilities to Python, providing file format support, efficient pixel data handling, and image manipulation operations.
Install it if you need to work with images in Python—it is the de facto standard for this task.
fonttools manipulates font files in multiple formats (TrueType, OpenType, AFM, Type 1, Mac-specific) and includes TTX, a tool to convert fonts to and from XML text format.
Install it if you need to read, write, or manipulate fonts programmatically or via the TTX command-line tool.
Enables matplotlib figures to display inline directly within Jupyter notebooks and IPython environments instead of in separate windows.
PyMuPDF extracts, renders, converts, and manipulates PDF and other document formats (XPS, EPUB, images, Office files via Pro) with high performance, providing text, tables, images, and metadata with precise layout information.
The AGPL license requires careful review if you are building proprietary software—commercial licensing is available from Artifex.
pypdfium2 is a Python binding to PDFium that enables PDF rendering, inspection, manipulation, and creation through a ctypes interface to Google's PDFium library.
Install it if you need PDF rendering, inspection, or manipulation in Python; the medium install friction is offset by comprehensive platform support.
Altair is a declarative Python library for creating interactive statistical visualizations by writing simple, readable code that compiles to Vega-Lite specifications.
See also blurhash-python · bitmap · sqids · qoi · hashids · base36 · pyoxipng · bech32m · pylzss · pyzbar