iLab GPT Conjure

_{GPT-image-2 WebUI 工作台 · Codex Responses / OpenAI 兼容 API · 图库、模板、历史库与并发任务}

iLab GPT Conjure WebUI 截图

简介

iLab GPT Conjure 是面向 GPT-image-2 的 AI 图片生成 WebUI 工作台，同时提供 CLI 便于本地自动化。它支持 Codex Responses 与 OpenAI 兼容 API 两种接入方式，并内置公用图库、多类型 chip 快捷引用、提示词模板、多任务并发、分页历史库和本地队列管理。

公开版推荐优先使用 OpenAI-compatible API 模式，通过你配置的供应商使用 Images API 或 Responses API 形态。

免安装一键包下载见下载 / Releases。

功能

面向 GPT-image-2 的文生图、参考图生成和图像编辑工作流。
支持 Codex Responses 和 OpenAI 兼容 API 接入；公开或共享使用优先选择 API 模式。
多任务并发、本地队列状态、分页历史库、缩略图和结果归档。
独立 /history 页面支持 SQLite 分页、搜索、筛选、网格/列表视图和懒加载详情。
单任务多图输出、部分失败处理和失败重试。
公用图库、最近参考图、颜色 chip、提示词片段 chip 和提示词模板。
WebUI 支持中文 / English 语言切换，顶栏可直接切换语言，偏好保存在当前浏览器。
免安装一键包内置一键更新脚本；启动脚本可检测最新 GitHub Release，并只显示更新提醒。
高级本机 OAuth 工作流支持个人本地 Codex 使用，并明确提示接口风险。
API 供应商配置，支持 Base URL、API Key、图像模型、调用方式和并发上限。
CLI 支持生成、参考图、图像编辑、mask 和 dry-run。

认证模式

推荐：OpenAI-compatible API

稳定集成、团队使用、共享工作站或可能公开提供服务的场景，应使用 API 模式。你可以在 WebUI 中配置 Base URL、API Key、模型名和调用方式。

高级本机模式：Codex / ChatGPT OAuth

本项目可选复用本机 Codex / ChatGPT OAuth 登录态，调用 ChatGPT 内部后端接口。该模式只面向个人本机工作流。

这不是 OpenAI 官方推荐的 API 集成方式。接口可能随时变更、失效，也可能受到账号、产品或用量规则影响。生产环境、团队部署、公开服务或需要稳定性的场景，应优先使用 OpenAI-compatible API 模式。

不要提交 OAuth 文件、API key、本地输入图、生成结果、任务 metadata、SQLite 数据库或调试日志。

环境要求

Python 3.11 或更高版本。
WebUI 依赖见 requirements-webui.txt。
修改 TypeScript 或 CSS 时需要 package.json 中的前端工具。

安装

git clone https://github.com/kadevin/ilab-gpt-conjure.git
cd ilab-gpt-conjure
python3 -m venv .venv
.venv/bin/python -m pip install -r requirements-webui.txt

启动 WebUI

macOS：

open "Start WebUI.command"

Windows：

Start WebUI.bat

手动启动：

.venv/bin/python -m uvicorn codex_image.webui.app:app --host 127.0.0.1 --port 8787 --no-access-log

然后打开：

http://127.0.0.1:8787/

免安装一键包

当前可用的一键包见下载 / Releases，也可以直接打开 GitHub Release v0.3.6。

这些包面向希望像 ComfyUI 一样“解压即用”的用户：

从下载页选择对应平台的 portable zip。
解压到普通用户目录。
Windows 双击 Start WebUI Portable.bat；macOS 双击 Start WebUI Portable.command。
如果浏览器没有自动打开，手动访问 http://127.0.0.1:8787/。

一键包内包含打包好的 CPython、已安装的 WebUI 依赖、应用源码、许可证文件，以及本地 data/ 目录。设置、公用图库、输入图、输出图、任务数据库和日志都会写入 data/。

启动脚本会短暂检测最新 GitHub Release；发现新版本时只显示提醒，不会自动更新。更新已经解压的一键包时，先关闭 WebUI 服务窗口，然后运行 Windows 的 Update WebUI Portable.bat 或 macOS 的 Update WebUI Portable.command。更新脚本会下载当前平台对应的最新 GitHub Release 资产，校验 SHA256，保留本地 data/，并把被替换文件备份到 .backup/。如果不希望启动时检查版本，可在启动前设置 ILAB_SKIP_VERSION_CHECK=1。

Apple Silicon Mac 下载 macos_portable_arm64，Intel Mac 下载 macos_portable_x64。

macOS 包是未签名 portable zip，不是已签名 .app 或 notarized DMG；构建它不需要 Apple Developer 账号。启动脚本会尝试在启动前移除当前解压目录内的 quarantine 标记，再启动包内 Python.framework。如果 macOS 仍然拦截下载后的启动脚本，可以右键或 Control-click Start WebUI Portable.command，选择 Open，并在系统安全提示里再次确认 Open。也可以对解压目录执行：

xattr -dr com.apple.quarantine /path/to/ilab-gpt-conjure_macos_portable_arm64
# 或：
xattr -dr com.apple.quarantine /path/to/ilab-gpt-conjure_macos_portable_x64

不要把一键包里的 Python、依赖、API key、OAuth 文件、本地输入图、生成结果、 SQLite 数据库或日志提交回 Git。

一键包打包和 CI 明确分离：Portable Release workflow 只会在 CI workflow 于 main push 上成功完成后运行，并上传 zip 与 SHA256 文件作为 workflow artifact。如果该提交带有 v* tag，同一份文件会上传到对应 GitHub Release。对于已经通过 CI 的 tag，也可以手动运行同一个 workflow，并填写 ref 与 release_tag。

WebUI 使用说明

在顶部选择认证来源。稳定使用建议选择 API，也就是 OpenAI-compatible API 模式；本机 OAuth 模式只建议个人本地工作流使用。
添加参考图：支持上传、拖拽、粘贴、最近上传和公用图库。
编写提示词：可直接输入文本，也可插入图库、颜色和片段 chip，并选择原始、保真或创意提示词模式。
设置数量、尺寸、方向、质量、输出格式和压缩率。
点击开始生成后，在左侧任务列表查看运行中和排队任务，在右侧预览区查看、精选、重试、下载、打包或归档结果；完整历史在 /history 中搜索和筛选。

公用图库（公共图库）

公用图库是本地可复用参考图资源库，适合保存固定人物、角色设定、产品主图、品牌素材、风格参考和其他长期复用图片。

上传图、最近上传图和生成结果都可以保存到公用图库。
右侧图库抽屉支持分类、命名、提示词用途、引用备注、替换原图、删除和拖拽排序。
可在图库抽屉中直接使用图片，也可以在提示词编辑器里输入 @ 搜索并插入。
图库文件只保存在本机。不要提交 input/、inputs/、output/、outputs/。如果后续删除图库条目，旧任务可能显示缺失引用。

三种 chip

提示词编辑器支持三种原子 chip：

@ 图库 chip：搜索公用图库，将选中的图片同步加入参考图输入，并为模型附加可见的参考图说明。
# 颜色 chip：插入 #FF6600 这类十六进制颜色，适合约束商品、海报、品牌、材质或背景色。
~ 提示词片段 chip：用短标签插入常用提示词片段。编辑器保持短标签可见，提交给模型时会展开为完整片段内容。

提示词片段可以从选中文本收藏，之后可用 ~、～ 或常见波浪号变体再次调用； chip 支持查看完整内容、展开为正文、编辑和复用。

提示词模板

提示词模板用于保存更长、可复用的生成结构，不是短句片段。模板默认保存在本机 output/webui-prompt-templates.json。

在提示词区域点击 管理模板库，可以搜索、按分类筛选、收藏、新建、编辑、复制、插入、替换、导入和导出模板。模板可以从历史任务结果中选择小缩略图辅助识别。

插入模板会写入当前可见提示词；替换模板会覆盖当前可见提示词。模板不会作为隐藏提示词注入。

CLI

.venv/bin/python -m codex_image --prompt "A clean product photo of a ceramic mug" --out output/mug.png

更多参数请使用 --help。

开发

.venv/bin/python -m unittest discover -s tests -v
npm run check:webui

修改前端 TypeScript 或 CSS 时，需要提交生成后的浏览器资源： codex_image/webui/static/。

GitHub CI 会在 pull request 和推送到 main 时运行 Python 测试和 WebUI 前端检查。后续 Release 一键包打包流程应接在 CI 成功之后。

许可证

本项目采用 GNU AGPLv3 协议。详见 LICENSE。

如果你修改本软件，并通过网络向用户提供服务，需要按照 AGPLv3 要求开放对应源码。

该许可证只适用于本项目代码，不授权项目名称、Logo、个人素材、API 凭据、用户提示词、输入图、输出图，或软件调用的模型/API 服务。

交流与定制开发

欢迎添加微信交流 AI 编程、AI 生图和本地图片生成工作流经验。

也接受合适的定制开发需求：

定制软件工具：本地工作台、内部自动化、批量处理、数据看板和 AI 生产流程。
企业网站：企业官网、产品展示、活动落地页和轻量后台管理系统。
智能体网站：客服问答、知识库检索、内容生成和业务流程助手类 Web 应用。

扫码添加微信时，可以备注 iLab GPT Conjure 或 定制开发，方便快速对齐需求。

iLab WeChat QR Code