materialyoucolor

What it is and what it does

materialyoucolor implements Material Design 3 color generation algorithms, allowing you to derive harmonious color palettes from a single source color or extract dominant colors from images. It provides multiple dynamic color scheme variants (Tonal Spot, Expressive, Fidelity, Monochrome, Neutral, Rainbow, Vibrant, Fruit Salad, Content) and can generate both static and dynamic color tokens in RGBA and hex formats.

The package wraps the official reference implementation, using a hybrid approach: TypeScript implementation for scheme generation and a C++ backend for fast color quantization. It depends only on pillow for image I/O and supports image-based color extraction with configurable quality. The C++ backend is recommended for large images due to pillow's memory inefficiency with full image materialization.

Use it for:

• Extract a dominant color palette from an image to theme an application UI dynamically
• Generate Material Design 3 color tokens for light and dark modes from a brand color
• Build a wallpaper-based theming system that adapts app colors to the current background
• Create color scheme variants for accessibility or user preference options
• Quantize large images efficiently to find representative colors without excessive memory consumption

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Generates Material Design 3 color schemes and palettes from source colors or images, implementing Google's official Material You color algorithms.

Yes, if you need Material Design 3 color generation. The package is actively maintained, has no known vulnerabilities, and offers a fast C++ backend for image processing. License status is unclear, so verify licensing terms before use in proprietary projects. Medium install friction is acceptable given prebuilt wheels for common platforms.

Install

materialyoucolor on PyPI

pip install materialyoucolor

uv add materialyoucolor

poetry add materialyoucolor

Installing materialyoucolor

Before you install

Medium install friction due to compiled backend for color quantization, but prebuilt wheels are available for common platforms and Python versions 3.10–3.13. Active maintenance with recent release.

Quickstart

pip install materialyoucolor

from materialyoucolor.scheme import Scheme
color = 0xff4181EE
print(Scheme.light(color).props)
print(Scheme.dark(color).props)

Verify before relying

• Whether the C++ quantization backend is automatically selected or requires manual configuration on all supported platforms
• Performance characteristics and memory usage of the pillow backend versus cpp backend on typical image sizes
• Whether the package works with Python 3.7 as documented or if prebuilt wheels only support 3.10+

Package facts

Evidence: materialyoucolor-3.0.4-cp310-cp310-macosx_10_9_x86_64.whl; materialyoucolor-3.0.4-cp310-cp310-macosx_11_0_arm64.whl; materialyoucolor-3.0.4-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl; materialyoucolor-3.0.4-cp310-cp310-musllinux_1_2_x86_64.whl; materialyoucolor-3.0.4-cp310-cp310-win32.whl; materialyoucolor-3.0.4-cp310-cp310-win_amd64.whl; materialyoucolor-3.0.4-cp311-cp311-macosx_10_9_x86_64.whl; materialyoucolor-3.0.4-cp311-cp311-macosx_11_0_arm64.whl; materialyoucolor-3.0.4-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl; materialyoucolor-3.0.4-cp311-cp311-musllinux_1_2_x86_64.whl; materialyoucolor-3.0.4-cp311-cp311-win32.whl; materialyoucolor-3.0.4-cp311-cp311-win_amd64.whl; materialyoucolor-3.0.4-cp312-cp312-macosx_10_13_x86_64.whl; materialyoucolor-3.0.4-cp312-cp312-macosx_11_0_arm64.whl; materialyoucolor-3.0.4-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl; materialyoucolor-3.0.4-cp312-cp312-musllinux_1_2_x86_64.whl; materialyoucolor-3.0.4-cp312-cp312-win32.whl; materialyoucolor-3.0.4-cp312-cp312-win_amd64.whl; materialyoucolor-3.0.4-cp313-cp313-macosx_10_13_x86_64.whl; materialyoucolor-3.0.4-cp313-cp313-macosx_11_0_arm64.whl

Tags

More Graphics packages