Skip to content

About

Local-first Windows client for GPT Image generation, multi-reference editing and async task workflows

Topics

Resources

Stars

16 stars

Watchers

0 watching

Forks

Repository files navigation

Muse Image

一个面向 Windows 桌面端的 GPT Image 2 图像创作工作台。支持文字生图、多参考图编辑、批量生成、项目管理、提示词复用和局部标注,不依赖 Python 或 Node.js 运行环境。

Muse Image 文字生图界面

产品概览

  • 用户问题:非技术用户难以正确配置模型接口与 API Key,也难以处理多参考图、并行生成、长任务等待、取消和失败恢复。
  • 产品方案:使用原生 Web 前端配合 Windows 本地 API 代理,把接口配置、生成任务、标注编辑、历史记录和文件下载封装为桌面工作流。
  • 我的工作:负责需求定义、产品流程、交互与界面、本地代理方案、任务状态设计、测试、Windows 启动器和用户文档。
  • 交付形态:无需安装 Python 或 Node.js,下载后通过 START_WINDOWS.cmd 启动;仓库提供源码、预编译服务、截图和完整演示视频。

该项目定位为独立开源客户端,不提供模型算力或托管服务;用户需要自行配置兼容接口并承担相应费用。

使用视频

点击观看 Muse Image 完整使用演示(约 2 分 10 秒)

功能

  • 文字生图,一次生成 1-4 张图片
  • 最多 4 张参考图的组合编辑
  • 生成任务状态、取消、失败提示和完整画幅预览
  • 画幅、质量和参考图提交策略控制
  • 图片框选、画笔标注、单步撤回和清除全部
  • 将标注结果直接发送到参考图编辑
  • 本地项目文件夹、作品历史和提示词预设
  • 可指定本机历史储存文件夹,按项目独立保存图片与记录索引
  • 查看、复制、复用提示词以及下载原图
  • 自定义兼容接口的 Base URL 与 API Key

界面

参考图编辑

四个固定参考图槽位按图 1 到图 4 排列,编辑任务和结果直接显示在中央工作区。

Muse Image 参考图编辑界面

局部标注

支持框选与画笔标注,可撤回、清除全部,并将带标注的图片发送到参考图编辑。

Muse Image 局部标注界面

快速开始

直接运行

  1. 下载或克隆仓库。
  2. 双击 START_WINDOWS.cmd。
  3. 浏览器将打开 http://127.0.0.1:8765/index.html。如果端口被占用,程序会自动尝试 8766-8785。
  4. 点击右上角 ...,填写兼容接口的 Base URL 和 API Key。
  5. 建议在设置中的“历史储存位置”选择一个本机文件夹;之后每个项目会有独立目录,生成图片和提示词索引会自动备份到其中。

项目内已包含预编译的 GPT_Image_Server.exe,Windows 10/11 无需额外安装运行环境。使用期间请保持启动窗口开启。

从源码编译本地服务

修改 portable_server.c 后,可通过 MinGW-w64 编译:

x86_64-w64-mingw32-gcc -O2 -Wall -o GPT_Image_Server.exe portable_server.c -lwinhttp -lws2_32 -lshell32 -luser32

也可以在已配置该编译器的环境中运行 BUILD_SERVER.cmd。

项目结构

index.html              单文件前端和主要业务逻辑
portable_server.c       Windows 本地静态服务与 API 代理
GPT_Image_Server.exe    预编译 Windows 可执行文件
START_WINDOWS.cmd       启动脚本
BUILD_SERVER.cmd        编译脚本
muse-logo.png           应用图标
output/                 运行后自动生成的项目历史图片与索引(不会提交到仓库)

数据与安全

  • 仓库不包含任何 Base URL 或 API Key。
  • 接口配置和提示词预设保存在浏览器本地;作品历史默认同步到应用目录旁的 output,浏览器 IndexedDB 作为快速读取缓存。
  • 选择历史储存文件夹后,根目录会生成 projects.json,每个项目目录内保存 records.json 和原始 PNG;清除浏览器站点数据后,可在设置中点击“从文件夹恢复”。
  • 历史文件夹由浏览器授权访问,重装浏览器或更换浏览器后可能需要重新点击“从文件夹恢复”并再次授权;请不要移动或删除该目录中的文件。
  • 本地服务只监听 127.0.0.1,不会主动暴露到局域网。
  • 不要公开带有密钥的设置截图或浏览器用户数据目录。
  • 生成请求可能产生接口费用,提交前请确认所使用服务的计费规则。

开发

前端由原生 HTML、CSS 和 JavaScript 构成,修改 index.html 后刷新页面即可。只有修改 portable_server.c 时才需要重新编译可执行文件。

更完整的 Windows 开发说明见 README_电脑开发版.md。

说明

本项目是独立的开源客户端,不隶属于或代表 OpenAI。GPT Image 2 及相关名称的权利归各自权利人所有。使用者应自行确保所连接接口、模型和生成内容符合服务条款及当地法律。

License

MIT

About

Local-first Windows client for GPT Image generation, multi-reference editing and async task workflows

Topics

Resources

Stars

16 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages