Skip to main content

No project description provided

Project description


PyColorPalette is a Python 3 tool capable of pulling a list of the top colors, or the color at a specific index, from a given image through the process of K-means clustering. Images can be provided either through a direct path or from a URL. Along with the RGB/Hex color value, you have the option to also retreive the percentage of the image that specific color takes up.

See examples below!


PyColorPalette derives a color palette using K-means clustering to create a cluster map. To see the cluster map use show_clustering=True. (Thank you, ZeevG)

from PyColorPalette import ColorPalette

pal = ColorPalette(r"/Users/user/Pictures/my_image.png", show_clustering=False)
#Use a raw string for Windows paths.

print(pal.get_top_colors(n=5, ratio=False, rounded=True))
# [(251, 243, 230), (101, 50, 81), (59, 18, 48), (58, 17, 47), (60, 19, 49)]

print(pal.get_color(index=3, ratio=True, rounded=True))
# ((58, 17, 47), 14)

Retrieve values in hex.
print(pal.get_color(index=3, ratio=True, to_hex=True, rounded=False))
# ('#3a112f', 14.1953125)


Alt text Alt text Alt text Alt text Alt text Alt text

Alt text Alt text Alt text Alt text Alt text Alt text

Alt text Alt text Alt text Alt text


PyColorPalette uses the Python Imaging Library (PIL) and numpy. To Install:

pip install Pillow 
pip install numpy

(Pillow and PIL cannot co-exist in the same environment. Before installing Pillow, please uninstall PIL if previosuly installed.)


pip install PyColorPalette

Project details

Download files

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

Files for PyColorPalette, version 1.2.3
Filename, size File type Python version Upload date Hashes
Filename, size PyColorPalette-1.2.3.tar.gz (4.8 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page