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
重要提示:导入功能默认禁用,直到你:
- 在
.env文件中添加OPENAI_API_KEY - 将你的参考照片(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.json和data/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.