Metadata-Version: 2.4
Name: pindouai
Version: 0.1.0
Summary: A utility to match digital colors to physical Perler Beads colors.
Author-email: PindouAI <hello@pindouai.app>
Project-URL: Homepage, https://pindouai.app
Project-URL: Generator Tool, https://pindouai.app/generator
Project-URL: Pattern Gallery, https://pindouai.app/gallery
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Multimedia :: Graphics
Requires-Python: >=3.7
Description-Content-Type: text/markdown

# 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](https://pindouai.app)**

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

```bash
pip install pindouai
```

## Usage

### As a CLI Tool

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

### In Python

```python
from pindouai import find_closest_color

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