# Gradio pallette

**Repository Path**: rainyf/gradio-pallette

## Basic Information

- **Project Name**: Gradio pallette
- **Description**: 实现调色板gradio页面应用
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-05
- **Last Updated**: 2025-12-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# KMeans 调色板提取器

一个专业的网页应用，可以分析上传照片的主色调（默认 5 色），并给出每个颜色的十六进制表示与可下载的调色板 PNG。

## 功能
- 上传任意图片，自动提取 `K` 个主色（K 默认 5，可在界面调整 2~12）。
- 右侧展示等比宽度的调色条图，体现每个颜色的占比。
- 输出对应的 HEX 颜色列表（可直接复制）。
- 提供调色板 PNG 文件下载。

## 快速开始（Windows / PowerShell）
```powershell
# 进入项目目录
cd d:\gradio-pallette

# 建议使用虚拟环境（可选）
python -m venv .venv; .\.venv\Scripts\Activate.ps1

# 安装依赖
pip install -r requirements.txt

# 启动服务
python app.py
```
启动后控制台会显示一个本地地址（通常是 http://127.0.0.1:7860/ ），点击打开即可使用。

## 原理简述
- 使用 `scikit-learn` 的 `KMeans` 对像素做聚类，得到 `K` 个聚类中心作为主色。
- 按簇内像素数量从大到小排序，计算每个颜色的权重并绘制调色板图。
- 将 RGB 颜色转为十六进制字符串输出。

## 目录结构
```
app.py              # 主应用（Gradio UI + 取色逻辑）
requirements.txt    # 依赖清单
README.md           # 说明文档
```

## 截图
可将运行后的界面截图粘贴到这里。