GitPedia

Hsluv python

Python implementation of HSLuv (revision 4)

From hsluv·Updated June 4, 2026·View on GitHub·

A Python implementation of [HSLuv](https://www.hsluv.org) (revision 4). The project is written primarily in Python, distributed under the MIT License license, first published in 2012. Key topics include: color-palettes, colors, colorspace, colorspaces, hpluv.

Latest release: v5.0.45.0.4
February 9, 2024View Changelog →

Build Status
Package Version

A Python implementation of HSLuv (revision 4).

Installation

pip install hsluv

Python 2 users: pip install hsluv==5.0.0

Usage

This library does not hide (clamp) floating point error, e.g. you might receive a value outside
of the expected range. If you wish to display the outputs of this library, consider rounding them
for your purpose. The floating point error has not been quantified, but at least 10 decimal digits
should be free of it.

hsluv_to_hex([hue, saturation, lightness])

hue is a float between 0 and 360, saturation and lightness are floats between 0 and 100. This
function returns the resulting color as a hex string.

hsluv_to_rgb([hue, saturation, lightness])

Like above, but returns a list of 3 floats between 0 and 1, for each RGB channel.

hex_to_hsluv(hex)

Takes a hex string and returns the HSLuv color as a list of floats as defined above.

rgb_to_hsluv([red, green, blue])

Like above, but red, green and blue are passed as floats between 0 and 1.

For HPLuv (the pastel variant), use hpluv_to_hex, hpluv_to_rgb, hex_to_hpluv and rgb_to_hpluv.

Testing

Run python setup.py test.

Authors

Contributors

Showing top 10 contributors by commit count.

View all contributors on GitHub →

This article is auto-generated from hsluv/hsluv-python via the GitHub API.Last fetched: 6/22/2026