Wardrobe:基于GPT-Image的AI衣物提取与整理工具

Wardrobe 利用 OpenAI 的 GPT-Image 模型,从照片中自动检测、提取并整理衣物,还可生成模特试穿效果。开源且数据本地优先。

什么是 Wardrobe?

Wardrobe 是一款开源工具,利用 OpenAI 的 GPT-Image 模型自动从你的照片中检测、提取并整理衣物。它不仅仅是简单的标签分类——还能生成干净的产品级抠图、模特风格的编辑预览,甚至推荐完整穿搭。所有数据均保存在本地。

为何重要

管理数字衣橱是一件麻烦事。大多数解决方案要么需要手动标注,要么将照片上传到隐私存疑的云服务。Wardrobe 解决了这两个问题:

  • 隐私优先:所有原始照片、生成图像及 JSON 数据库均保存在本地的 data/ 目录中。
  • AI 驱动:利用 OpenAI 最新的视觉与图像生成模型(gpt-5.4-mini 和 gpt-image-2)处理繁重任务。
  • 可扩展:内置 Codex 技能用于导入衣物和生成穿搭,你也可以直接使用 Web 界面。

快速开始

git clone https://github.com/tandpfun/wardrobe.git
cd wardrobe
npm install
cp .env.example .env
npm run dev

重要提示:导入功能默认禁用,直到你:

  1. .env 文件中添加 OPENAI_API_KEY
  2. 将你的参考照片(PNG 格式)放在 data/model-reference.png

然后打开 localhost:5173 即可使用。

工作原理

1. 衣物检测

当你上传照片(通过拖拽、粘贴或导入技能)时,Wardrobe 将其发送至 OpenAI Responses API。模型识别图像中的每件衣物——衬衫、裤子、鞋子、配饰——并返回边界框或分割数据。

2. 干净抠图

利用 OpenAI Images API,Wardrobe 将检测到的每件衣物提取为干净的产品级抠图。这能去除背景并隔离物品,便于编目或生成穿搭。

3. 模特风格预览

如果你提供了模特参考照片,Wardrobe 可以生成模特风格的编辑预览——在模特(你或生成的人物)身上展示衣物,营造出类似摄影棚的迷人效果。

4. 本地存储

所有内容均保存在本地:

  • data/library.json —— 所有物品的主数据库
  • data/imported/ —— 原始照片和生成图像
  • data/model-reference.png —— 你的参考照片

使用 Codex 导入

这是 Wardrobe 的真正亮点。它包含两个 Codex 技能,可自动化整个工作流程:

$import-clothes

从 ~/Pictures/outfits 导入衣物,生成模特照片,并添加到当前衣橱。

该技能:

  • 扫描文件夹(或相册)中的衣物照片
  • 在需要时请求本地模特参考 PNG
  • 在保存前审查每个抠图和模特照片
  • 写入 data/library.jsondata/imported/

$generate-outfits

根据我的衣橱生成模特穿搭创意。

该技能:

  • 询问要创建多少套造型
  • 从现有衣橱中精选组合
  • 为每套穿搭生成模特预览
  • 验证并将完整集合保存到 data/ 目录下

配置

变量 默认值 描述
OPENAI_API_KEY 必填 你的 OpenAI API 密钥
OPENAI_VISION_MODEL gpt-5.4-mini 用于衣物检测的模型
OPENAI_IMAGE_MODEL gpt-image-2 用于抠图和预览生成的模型
OPENAI_IMAGE_QUALITY high 生成图像的画质设置
WARDROBE_MODEL_REFERENCE data/model-reference.png 参考照片路径
WARDROBE_DATA_DIR data 所有本地数据的目录

使用场景

  • 个人衣橱管理:整理衣物,查看拥有物品,获取穿搭建议。
  • 电商产品摄影:快速生成干净抠图和模特预览,用于在线商品展示。
  • 时装设计:尝试不同组合,在确定前可视化穿搭效果。
  • 内容创作:为社交媒体或博客生成一致的高质量图片。

技术细节

  • 技术栈:JavaScript (74.3%), CSS (25.1%), HTML (0.6%)
  • 构建工具:Vite
  • 运行环境:Node 22+
  • 许可证:MIT

总结

Wardrobe 是一款实用且尊重隐私的工具,利用前沿 AI 解决实际问题。无论你是时尚爱好者、小企业主,还是只想整理衣柜的人,都值得一试。Codex 技能使其在批量处理时尤为强大,而本地优先的方法确保你始终掌控自己的数据。

查看 GitHub 仓库 开始使用。

来源

tandpfun/wardrobe: Your clothes, extracted and organized with gpt-image.