---
id: numcodecs
version: "0.16.5"
license: MIT
license_treatment: permissive
maintenance: active
---

# numcodecs — A Python package providing buffer compression and transformation codecs for use in data storage and communication applications.

License: permissive · Maintenance: active · Downloads: 9.6M/mo

## What it is and what it does

Numcodecs is a Python library for encoding and decoding data buffers using various compression and transformation algorithms. It sits between raw data and storage or transmission layers, allowing you to compress arrays and binary data efficiently. The package wraps multiple codec implementations and provides a consistent interface for applying them.

Typically used in data science and storage applications where you need to reduce data size or apply reversible transformations before persisting or transmitting arrays. It depends on numpy for array handling and typing_extensions for type hints, and supports modern Python versions from 3.11 onward. The library is actively maintained and available as precompiled wheels for common platforms.

Use it for:

- Compress large numerical arrays before writing to disk in data pipelines
- Apply reversible data transformations in zarr-based storage systems
- Reduce network bandwidth when transmitting binary data between services
- Implement custom codec chains for specialized data encoding workflows
- Integrate compression into HDF5 or other hierarchical data formats

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Numcodecs provides buffer compression and transformation codecs for efficient data storage and communication, with support for multiple compression algorithms and data transformations.

Yes. Numcodecs is actively maintained, has no known vulnerabilities, uses a permissive MIT license, and ranks in the top 5000 PyPI packages by download volume. Medium install friction is acceptable for a compiled library. Install it if you need flexible buffer compression or data transformation codecs in storage or communication applications.

## Install

pip install numcodecs
uv add numcodecs
poetry add numcodecs

## Installing numcodecs

Before you install: Medium install friction due to compiled wheels for multiple Python versions and platforms. Active maintenance with recent commits; last release 266 days ago and repository shows ongoing development.

License in practice: MIT license permits free use, modification, and distribution with minimal restrictions, making it suitable for both open-source and commercial projects.

Quickstart:

pip install numcodecs
import numcodecs
codec = numcodecs.Blosc(cname='zstd', clevel=5)
compressed = codec.encode(data)
decompressed = codec.decode(compressed)

Requires Python 3.11 or later; numpy and typing_extensions are runtime dependencies.

Verify before relying:

- Specific compression algorithms and codecs available beyond what the fact sheet describes
- Performance characteristics or compression ratio benchmarks for different codec types
- Integration patterns with zarr or other storage systems mentioned in repository URL

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: medium
- Maintenance: active
- Downloads: 9.6M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

buffer compression codecs, data compression library, codec for data storage, array compression, data transformation codecs, compression, data-storage, codecs

[View on SkillFed](https://skillfed.io/packages/numcodecs) · [View on PyPI](https://pypi.org/project/numcodecs/)