# 实现调色板gradio网页应用

**Repository Path**: YXY0216/palette

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-18
- **Last Updated**: 2025-12-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# KMeans 调色板提取器

使用 KMeans 从上传图片中提取 5 个主色调，并展示：
- 横向调色板 PNG
- 每个颜色的十六进制表示
- 可下载的调色板图片

## 快速开始（Windows PowerShell）

```powershell
# 1) 建议新建虚拟环境（可选）
python -m venv .venv; .\.venv\Scripts\Activate.ps1

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

# 3) 运行应用
python .\app.py
```

启动后在浏览器访问 `http://127.0.0.1:7860/`，上传图片并点击 Submit 即可。

## 说明
- 聚类默认使用 `LAB` 空间（需 `opencv-python`）。如未安装/不可用，会自动退化为 `RGB` 空间，效果依然可用。
- 结果颜色按聚类占比从大到小排序，更接近“主色调”。
- 支持透明 PNG：会自动忽略完全透明的像素。

## 常见问题
- 如果端口占用，可修改 `app.py` 末尾的 `server_port` 值。
- 若运行时报 `DLL load failed` 等 OpenCV 相关问题，先尝试更新 pip/重装 `opencv-python`，或让程序在 RGB 模式运行（无需额外操作，自动降级）。