项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-11-07 · 当前星标 ★ 1557
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- GIMP 3.0 或更高版本
- 独立安装的 Python 3.10+,并带 venv/pip
- 可正常访问所选模型 API 服务的网络环境
- 已充值的 OpenRouter 或 Google API 账户
安装与启动步骤
-
1核对环境依赖
先确认 GIMP 为 3.x 版本,并已单独安装 Python 3.10+(Homebrew 或 python.org 均可),安装器只下载依赖、不装 Python。
python3 --version -
2获取项目源码
从项目 GitHub 仓库页面下载源码压缩包或克隆到本地,解压后进入包含 scripts 目录的项目根目录。
-
3运行源码安装脚本
在项目根目录执行脚本,会自动创建 .venv 虚拟环境,并把插件复制到 GIMP 用户插件目录。
python3 scripts/install.py -
4自定义 GIMP 路径
若 GIMP 不在默认位置,加 --gimp 参数指向实际的应用路径再执行安装。
python3 scripts/install.py --gimp "/Applications/GIMP.app" -
5macOS 磁盘映像安装
macOS 13+ 可打开 GIMP-ML-macOS.dmg,先 Cmd+Q 完全退出 GIMP,再双击 Install GIMP-ML;路径不符时点 Choose GIMP 选择。
-
6配置 API 并打开菜单
重启 GIMP,在 Filters > GIMP-ML 打开生成/编辑对话框,填入 OpenRouter 或 Google 的密钥并选择模型。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
API 提供方 | 是 | 选择通过 OpenRouter 或 Google 调用 Gemini 模型 | OpenRouter |
API 密钥 | 是 | 所选用 API 账户的密钥,需账户已充值 | sk-or-v1-xxxxxxxx |
模型名称 | 否 | 生成/编辑图像所用的 Gemini 图像模型 | gemini-2.5-flash-image |
如何确认成功
重启 GIMP 后,菜单栏 Filters 下出现 GIMP-ML 子菜单并能打开生成对话框,即表示安装成功。
常见问题
Q:需要独立显卡或本地模型吗?
A:不需要。插件通过 OpenRouter 或 Google 调用云端模型,无需本地模型、GPU,也没有单独的界面程序。
Q:安装脚本会改动 GIMP 自带的 Python 吗?
A:不会。脚本只创建独立的 .venv 虚拟环境,并把插件复制到 GIMP 的用户插件目录,不影响其他插件。
Q:生成的图像会覆盖原图吗?
A:默认把结果输出为新图层,便于继续非破坏性编辑;像素替换模式也是可撤销的。
Q:安装中途可以中断吗?
A:macOS 安装窗口支持 Ctrl+C 中断;结束后终端会切换为交互式 Bash,先点 Done 关闭窗口再推出磁盘映像。
Q:提示找不到 Python 怎么办?
A:安装器不会自动装 Python,需先用 Homebrew 或 python.org 安装 Python 3.10 以上版本后重新运行安装。
注意事项
- 必须先完全退出 GIMP(macOS 用 Cmd+Q)再执行安装,否则插件可能不生效。
- 使用前需准备已充值的 API 账户,并保证网络可正常访问所选的 API 服务。
- 本插件仅支持 GIMP 3.0 及以上版本,GIMP 2.x 无法使用。
核心亮点
- 把超分、去噪、抠图、上色、风格迁移等任务直接嵌进 GIMP 菜单,结果落到新图层,保留非破坏性编辑流程
- 纯 Python 实现,模型与 OpenCV、PyTorch 生态对接,便于二次开发和替换自己的权重
- 覆盖 Linux 与 macOS,安装以脚本为主,对熟悉命令行的 GIMP 用户门槛不高
不足之处
- 依赖 GIMP 版本与 Python 环境匹配,升级 GIMP 或换 Python 版本后容易出现插件加载失败
- 部分模型体积大、首次运行需下载权重,CPU 推理速度较慢,对显卡与内存有要求
- 界面以菜单项为主,参数调节和批量处理能力有限,缺少统一的任务队列与预设管理
适用场景
- 老照片修复:先去噪再超分辨率放大,结果作为新图层与原图对比调整
- 电商或自媒体素材预处理:批量抠图换背景、统一尺寸与清晰度
- 创意实验:用风格迁移、上色和语义分割快速试出配色与构图方案
替代项目
Stable Diffusion WebUI、ComfyUI、Upscayl
上一篇:PhotoDemon
下一篇:没有了!
同类项目推荐
awesome-gpt4o-images
开源
看GPT-4o神图,抄提示词,秒出同款风格
Awesome curated collection of images and prompts generated by GPT-4o and gpt-image-1···
invertible-cd
开源
7步内完成高质量文本引导图像编辑,让扩散模型编辑提速十倍。
[NeurIPS'2024] Invertible Consistency Distillation for Text-Guided Image Editing in ···
Lucy-Edit-ComfyUI
开源
在 ComfyUI 里用一句话指令改图
artbot-for-stable-diffusion
开源
免配置,用浏览器直连分布式算力,轻松生成 AI 艺术图
A front-end GUI for interacting with the AI Horde / Stable Diffusion distributed clu···
Mix-Studio
开源
手机电脑都能跑,干净流畅的 ComfyUI 工作台
The cleanest, responsive AI workspace. Run highly tuned image and video workflows fl···
UniPic
开源
一句话指令,多图联动编辑,效果媲美商业模型
Open-source SOTA multi-image editing model
geopattern
开源
输入字符串,秒出几何背景图
:triangular_ruler: Create beautiful generative image patterns from a string in golan···
ID-Patch
开源
让群体照片生成时,每个人的脸都能对号入座
Official implementation of CVPR 2025 paper "ID-Patch: Robust ID Association for Grou···
joliGEN
开源
用 GAN 和扩散模型搞定真实图像视频生成与编辑
Generative AI Image and Video Toolset with GANs and Diffusion for Real-World Applica···
