---
id: materialyoucolor
version: "3.0.4"
license: unclear
license_treatment: unclear
maintenance: active
---

# materialyoucolor — Material You color generation algorithms in pure python!

License: unclear · Maintenance: active · Downloads: 123.3K/mo

## 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 above — 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

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

- License: not declared (unclear)
- Python support: supports_current
- Install friction: medium
- Maintenance: active
- Downloads: 123.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

material design 3 color generation, material you color scheme, dynamic color palette from image, material color quantization, hct color space python, color-generation, material-design, image-processing

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