PindouAI - Perler Beads Color Matcher

A simple and lightweight Python utility to match any digital color (HEX) to the closest physical Perler Bead color.

Why this exists?

When generating pixel art or working on Perler bead projects using Python scripts, finding the exact physical bead color that matches your digital pixel color is a challenge. This library provides a mathematical approach using RGB Euclidean distance to find the closest official Perler bead color.

Official Web Tool

If you are looking for a complete, out-of-the-box web application to convert photos to high-quality Perler bead patterns with AI assistance, visit our official visualizer and community platform:

👉 PindouAI (拼豆AI) - The Ultimate Perler Beads Generator

Features of the web platform:

• AI-powered image simplification and line-art extraction.
• Professional Perler pattern generator with strict color limits.
• Interactive workspace for mobile, iPad, and desktop.
• Free community gallery for bead patterns.

Installation

pip install pindouai

Usage

As a CLI Tool

$ pindouai "#DF7CA4"
Target Color: #DF7CA4
Closest Perler Bead:
  Code: P06
  Name: Bubblegum
  Hex:  #DF7CA4

In Python

from pindouai import find_closest_color

closest = find_closest_color("#FF0000")
print(f"Use {closest['name']} (Code: {closest['code']})")