Skip to main content

A HUSL color space conversion library that works with numpy

Project description

HUSL color space conversion

A color space conversion library that works with numpy. See to learn about the HUSL color space.


1. Fast conversion to RGB from HUSL and vice versa. Convert a 1080p image to HUSL in less than a second. 2. Seamless performance improvements with NumExpr, Cython, and OpenMP (whichever’s available). 3. Flexible numpy arrays as inputs and outputs. Plays nicely with OpenCV, MoviePy, etc.


  1. virtualenv env -p python3
  2. source env/bin/activate
  3. pip install numpy
  4. (optional) pip install Cython (or NumExpr, but Cython is preferred)
  5. pip install git+

Basic usage

  • to_rgb(hsl) Convert HUSL array to RGB integer array
  • to_husl(rgb) Convert RGB integer array or grayscale float array to HUSL
  • array
  • to_hue(rgb) Convert RGB integer array or grayscale float array to array of
  • hue values


See for complete documentation.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nphusl-1.4.1.tar.gz (63.3 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page