# image-matting

**Repository Path**: github-rocks/image-matting

## Basic Information

- **Project Name**: image-matting
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-02
- **Last Updated**: 2026-04-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


# AI抠图项目

>使用开源模型 [briaai/RMBG-1.4](https://huggingface.co/briaai/RMBG-1.4)实现图像抠图。
>
> 本项目主要是为了学习和实践AI技术、gui开发、前端学习、i18n国际化等技术

## 项目介绍

- 本地模型算法进行抠图，支持单张和批量抠图
- 支持单张抠图和批量抠图
- 支持AI抠图结果导出png/psd/jpg格式
- 支持AI图像修补
- 支持二次编辑
- 支持拖拽和粘贴
- AI证件照抠图功能
- 支持图片格式转换、批量转换
- 支持图片压缩、批量压缩
- 语言支持中文和英文
- 支持暗色和亮色主题
- 项目开源，可供学习和参考

## TODO

- [x] 优化图片编辑功能，解决了放大缩小移动导致状态混乱的问题，**现在移动、放大、缩小、橡皮擦、撤销和回退等功能已正常运行**。
- [x] 增加AI抠图结果页的背景颜色切换功能
- [ ] ~~图片转换支持 AVIF 格式， 参考[issues/10](https://github.com/pangxiaobin/image-matting/issues/10)~~
- [x] 增加图片导出格式配置，支持psd、png、jpg等格式
- [x] 优化图片格式转换，gif图转为其他格式，支持保存gif的每一帧
- [x] 编辑功能中增加涂抹恢复功能


## tips

> 制作证件照时，可以灵活使用缩小、放大功能和移动选框来调整人物位置和需要的部位。
> 抠gif图时，可以先转为png或jpg格式，会生成一个文件夹，然后在使用批量抠图功能进行批量抠图。
>

## License

使用 [CC BY-NC 4.0](./LICENSE) 协议并依据[https://huggingface.co/briaai/RMBG-1.4](https://huggingface.co/briaai/RMBG-1.4)要求的许可证，本项目不可用于商业用途。本项目的打包的软件中，除非另有说明，否则不得隐匿作者相关信息。

## 常见问题

### 1.  windows系统下，如果出现无法启动客户端的情况，请尝试以下操作
  
>本项目使用pywebview开发，在windows系统下会查找edgechromium ，edgehtml， mshtml 的客户端引擎依次检索。如果本地电脑 edge 浏览器支持这些引擎，则客户端可以正常启动。否则，需要安装对应的 [EdgeWebView2Runtime](https://developer.microsoft.com/en-us/microsoft-edge/webview2/?form=MA13LH) 浏览器引擎。

### 2.  windows系统如果运行时提示STATUS_ILLEGAL_INSTRUCTION，页面崩溃

> 请尝试更新Microsoft Edge到最新版本

### 赞助支持

> 如果您觉得项目对您有帮助，欢迎赞助支持。

[捐赠列表](https://github.com/pangxiaobin/image-matting/wiki/Sponsor-Page)

<img src= "./imgs/wx_sponsor.png" width='50%' alt='赞助支持' />

### 鸣谢

感谢[nzls1795724370](https://github.com/nzls1795724370) 提供的图标设计

### 安装打包

[文档](./backend/README.md)

### 历史版本记录

#### v0.2.5

- 增加AI图像修补功能
- 增加API接口，文档默认地址：<http://localhost:11111/api/docs>

#### v0.2.4

- 优化图像边缘处理，减少黑边
- 增加边缘处理的配置项，可选择是否开启边缘处理，默认开启
- 增加边缘处理的度

#### v0.2.3

- 修复批量抠图时，webp格式文件被跳过的问题
- 图片编辑新增涂抹恢复功能

#### v0.2.2

- 修复Windows下重复打开窗口，可能会导致再次打开时无法展示的问题
- 修复AI抠图结果页，空白背景板展示为白色的问题
- 新增gif转其他类似格式，支持每一帧的保存，并存储为文件夹
- 新增导出psd文件时，增加原图的数据，以便于查看原图的效果

#### v0.2.1

- 优化图片编辑功能，现在移动、放大、缩小、橡皮擦、撤销和回退等功能丝滑运行

#### v0.2.0

- 更改模型加载方式，打包体积缩小一倍
- 修复编辑图像后会存在图像分辨率降低的bug
- 新增版本检查按钮，方便及时获取最新版本
  
📢: 注意

- 开发模式，目前使用python版本为3.11.9，开发模式需要把之前的环境删除，安装3.11.9版本的python环境。
- 把之前的backend/hub_model下的briaai 文件删除，执行 pdm run python hub_model/download.py 下载新模型。

#### v0.1.6

- 增加AI抠图结果页的背景颜色切换功能
- 增加图片导出格式配置，支持psd、png、jpg等格式
- 新增导出格式配置项

#### v0.1.5

- 更新图标样式
- 新增抠图结果编辑界面，支持橡皮擦功能

#### v0.1.4

- 新增图片压缩和批量压缩
- 优化windows 界面展示
- 新增about页面
- 新增tinypng key 设置页面
- 更新前端依赖，修复vue router not support params

#### v0.1.3

- 新增图片格式批量转换
- 新增窗口置顶
- 修复win图标不展示问题

#### v0.1.2

- 新增图片格式转换
- 增加图片展示组件

#### v0.1.1

- 新增证件照抠图功能；
- 解决windows 打开文件异常；
- 已更新win 打包确少模型依赖文件；

#### v0.1.0

- 项目初始化版本,基础AI抠图功能

### 操作演示视频

[bilibili](https://www.bilibili.com/video/BV1PksZeoEQR/)

### 运行截图

![运行截图](./imgs/1.png)
![运行截图](./imgs/2.png)
![运行截图](./imgs/3.png)
![运行截图](./imgs/4.png)
![运行截图](./imgs/5.png)
![运行截图](./imgs/6.png)
![运行截图](./imgs/8.png)
![运行截图](./imgs/9.png)
![运行截图](./imgs/10.png)
![运行截图](./imgs/11.png)
![运行截图](./imgs/12.png)
![运行截图](./imgs/13.png)
![运行截图](./imgs/14.png)
![运行截图](./imgs/15.png)
![运行截图](./imgs/16.png)
![运行截图](./imgs/7.gif)

## Star History

[![Star History Chart](https://api.star-history.com/svg?repos=pangxiaobin/image-matting&type=Date)](https://star-history.com/#pangxiaobin/image-matting&Date)