← Back to Wardrowbe

Open Source Wardrobe App

Wardrowbe is an open source wardrobe manager with AI tagging and outfit suggestions, released under the MIT License. The whole stack is on GitHub and you can self-host it with Docker Compose. Nothing is held back from the self-hosted build: no item caps, no paywalled features.

View on GitHubInstall instructions

What You Get

  • AI item tagging. Photograph a garment and a vision model identifies type, colour, pattern, style, and formality.
  • Outfit suggestions. Generated from live weather, occasion, wear history, and learned preferences.
  • Your choice of AI backend. Ollama locally, OpenAI, or any OpenAI-compatible endpoint. Set it in one environment variable.
  • Web and mobile. A Next.js dashboard plus a React Native app for iOS and Android.
  • Multi-arch images. linux/amd64 and linux/arm64, so a Raspberry Pi or ARM NAS runs it without building from source.
  • Eight languages in the self-hosted build, ahead of the cloud version. See the i18n writeup.

Quick Start

You need Docker, Docker Compose, at least 4GB of RAM, and an AI endpoint. The compose file pulls pre-built images from the GitHub Container Registry, so no build tooling is required on the host.

git clone https://github.com/Anyesh/wardrowbe.git
cd wardrowbe
cp .env.example .env

# Point AI_BASE_URL at Ollama or any OpenAI-compatible endpoint,
# then pull the published images and start the stack.
docker compose pull
docker compose up -d
docker compose exec backend alembic upgrade head

curl http://localhost:8000/api/v1/health

The web app is then on http://localhost:3000 and the API docs on http://localhost:8000/docs.

Requirements

RuntimeDocker and Docker Compose
Memory4GB RAM minimum
Architectureslinux/amd64, linux/arm64
AI endpointOllama (free, local), OpenAI, or any OpenAI-compatible API
DatabasePostgreSQL, included in the compose stack
LicenseMIT

Where Your Data Goes

Your database and images sit on your hardware. The one thing that can leave your network is the image sent for AI analysis, and that is entirely determined by the endpoint you configure. Point AI_BASE_URL at a local Ollama instance and no photo ever leaves the machine. Point it at OpenAI and photos go to OpenAI. This is a single line in your environment file and you can change it whenever you like.

We think this matters more than it first appears, because a wardrobe app ends up holding a photographed inventory of everything you own. We wrote about that in what your wardrobe data reveals.

Self-Hosted or Cloud

The self-hosted build is complete and free. You maintain the server, apply updates, and supply an AI endpoint, and the quality of tagging depends on which model you point it at. The cloud service exists for people who would rather not run a server, and it pays for continued work on the open source project. We compared the two honestly in cloud versus self-hosted, and put Wardrowbe next to the other self-hostable options in the best self-hosted wardrobe apps.

Frequently Asked Questions

Is there an open source wardrobe app?

Yes. Wardrowbe is open source under the MIT License and the full stack is on GitHub: backend, web frontend, mobile app, and the AI pipeline. You can self-host it with Docker Compose and there are no feature restrictions in the self-hosted build. OpenWardrobe is another open source option, though it is a manual cataloger with no AI or outfit generation.

What do I need to self-host Wardrowbe?

Docker and Docker Compose, at least 4GB of RAM, and an AI endpoint. The AI endpoint can be Ollama running locally for free, OpenAI, or any OpenAI-compatible API. Published images are multi-arch for linux/amd64 and linux/arm64, so a Raspberry Pi or an ARM NAS works without building anything from source.

Is the self-hosted version feature limited compared to the cloud one?

No. The self-hosted build has no item caps and no paywalled features. The practical differences are that you run and update the server yourself, and you supply your own AI endpoint, which determines tagging quality. The cloud service exists for people who do not want to run a server, and it funds development of the open source project.

Does self-hosting mean my clothing photos stay private?

Your photos and database stay on your hardware. Whether an image leaves your network depends on the AI endpoint you configure. Point it at a local Ollama instance and no image ever leaves the machine. Point it at OpenAI and images are sent to OpenAI for analysis. You choose this in the environment file and can change it at any time.

What license is Wardrowbe released under?

The MIT License, which permits commercial use, modification, distribution, and private use, and requires only that the copyright notice is preserved.

Contribute

Issues and pull requests are welcome. The most recent release added eight-language support to the self-hosted build, which started as a contributor pull request. Star the repository if you find it useful, it genuinely helps other people find it.

View on GitHubTry the cloud version