# Implement a color palette Gradio web application

**Repository Path**: xv514/implement-a-color-palette-gradio-web-application

## Basic Information

- **Project Name**: Implement a color palette Gradio web application
- **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-11-14
- **Last Updated**: 2025-11-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# KMeans 调色板提取器

一款基于 Gradio 的专业网页应用，可分析上传照片并提取 5 个主色调，同时展示每个颜色对应的十六进制代码。

# 项目运行效果截图
![alt text](<屏幕截图 2025-11-14 084134.png>)

## 功能

1. 图像上传与调色板生成：上传图片后，应用会通过 KMeans 聚类算法自动分析图像，提取 5 个最具代表性的主色调，生成可视化调色板。
2. 可选裁剪功能：支持开启裁剪模式，手动设置图像裁剪区域的坐标，仅对指定区域进行颜色分析，满足局部调色需求。
3. 十六进制码展示：清晰显示每个主色调的十六进制代码，可直接复制用于设计、开发等场景。

## 依赖

- Python 3.x（推荐 3.8 及以上版本）
- NumPy
- OpenCV-Python
- scikit-learn
- Gradio

## 使用

1. 克隆或下载此项目。
2. 安装依赖库：在项目根目录打开终端，执行以下命令:
```bash
pip install numpy opencv-python scikit-learn gradio
```
3. 启动应用：执行命令
```bash
 python app.py
 ```
 启动后终端会显示服务地址。
4.访问应用：打开浏览器，输入地址 `http://127.0.0.1:5001`，即可进入应用界面。
5.操作流程：
- 在「上传图像」区域上传 JPG、PNG 等常见格式的图片；
- 点击「提取调色板」按钮，等待片刻后即可查看生成的调色板预览和对应的十六进制代码。

## 注意

1.本项目仅用于演示和学习，若需用于生产环境，建议补充完善错误处理（如异常图像格式、空文件上传）和性能优化（如大图像压缩处理）。
2.上传图像建议选择清晰度较高、色彩分布明确的图片，以确保主色调提取结果更精准。
3.若启动时提示 “端口 5001 被占用”，可修改 `app.py` 中 demo.launch() 里的 server_port 参数（如改为 5002），重新运行即可。

## 个人信息

- 学号: 202352320224
- 年级: 2023
- 专业: 智能科学与技术
- 班级: 2 班