wardrobe README

The project's README from github.com/tandpfun/wardrobe. As one markdown file: README.md.

Wardrobe

Your clothes, extracted and organized with gpt-image.

License: MIT Node 22+

See the original post →

Wardrobe gallery

Modeled wardrobe editor

Quick start

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

⚠️ The importer stays disabled until you add OPENAI_API_KEY to .env and place a PNG reference photo of yourself at data/model-reference.png.

Open localhost:5173.

Import with Codex

This repo includes two Codex skills: one imports clothes and generates modeled item photos; the other styles complete outfits and generates a modeled lookbook.

$import-clothes Import the clothes from ~/Pictures/outfits, create modeled photos, and add them to this wardrobe.
$generate-outfits Create modeled outfit ideas from my wardrobe.

Open the cloned repo in Codex and run either prompt. The import skill asks for a local model-reference PNG when needed, reviews every cutout and modeled photo, then writes to data/library.json and data/imported/. The outfit skill asks how many looks to create, then curates, generates, verifies, and saves the complete collection under data/.

For agents

If you are setting up Wardrobe for a user, ask how they want to import their clothes:

What it does

Configuration

Variable Default
OPENAI_API_KEY Required
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

License

MIT

wardrobe (tandpfun/wardrobe)

Searching Database…

What is this?Wardrobe is a self-hosted app that detects the clothes in a photo, extracts clean product cutouts with OpenAI's image API, and organizes them into a personal digital wardrobe, optionally generating modeled editorial previews with gpt-image-2.
Is this a web app I run on my own machine?Yes, it's a local web app served at localhost:5173, and it keeps your photos plus the JSON wardrobe database entirely in a local data/ folder instead of a remote server.
How do I get it running?Add your OPENAI_API_KEY to .env and place a PNG reference photo of yourself at data/model-reference.png, then open localhost:5173 to start importing clothes.
Do I need an OpenAI API key?Yes, OPENAI_API_KEY is required, and you also need your own reference photo so the app can generate modeled previews of your clothes.
Does the importer work right out of the box?No, the importer stays disabled until you've supplied an OpenAI API key and a model-reference PNG, so there's required setup before you can import anything.
Where does my wardrobe data go?Everything — original photos, generated images, jobs, and the JSON database — stays local in the data/ folder rather than being stored on a remote server, besides the OpenAI API calls needed for detection and image generation.
What are the two Codex skills for?One imports clothes from photos and generates modeled item photos, while the other styles complete outfits and creates a modeled lookbook; both run directly inside Codex on the cloned repo.
Can I swap out the default OpenAI models?Yes, the vision and image models are configurable via OPENAI_VISION_MODEL and OPENAI_IMAGE_MODEL env vars, which default to gpt-5.4-mini and gpt-image-2.
Why does it need a reference photo of me?The model-reference PNG is used to generate the optional modeled editorial preview, showing how an extracted garment would look worn by you.
Can it put together full outfits, not just single items?Yes, the outfit-generation Codex skill asks how many looks to create, then curates, generates, verifies, and saves a complete modeled lookbook under data/.
Creator
tandpfun
Size
3.1 MB
Stars
2.2K
Updated
CommitJul 16
Age
3mo
Commits · 90 Days