← Back to Wardrowbe

Open Source Wardrobe App

The core of Wardrowbe, a wardrobe manager with AI tagging and outfit suggestions, is open source under the MIT License. The backend and web app are on GitHub and you can self-host them with Docker Compose, with no item caps and no license key. Wardrowbe Cloud adds a few features on top, listed under self-hosted or cloud below.

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 in the repository. The Wardrowbe iOS and Android apps are free downloads, not open source, and can connect to your server.
  • 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 free and has the core of the app. You maintain the server, apply updates, and supply an AI endpoint, and the quality of tagging depends on which model you point it at.

Wardrowbe Cloud adds these on top of the open source core:

  • Virtual try-on runs on GPU servers we rent.
  • Partner store suggestions rely on our agreements with stores and affiliate networks.
  • Sign in with Apple and Google, subscriptions and billing are tied to our developer and payment accounts.
  • Receipt import, adding items from a text description, and achievements were built for the cloud service.
  • The iOS and Android apps are published by us and are not open source. They work with the cloud service and with your own server.

The cloud service is for people who would rather not run a server, and its subscriptions pay 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. The core of Wardrowbe is open source under the MIT License and on GitHub: the backend, the web app, AI tagging and outfit suggestions. You can self-host it with Docker Compose, with no item caps. Wardrowbe Cloud adds virtual try-on and partner store suggestions, and the iOS and Android apps are published separately; none of these are in the repository. 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?

The core features are the same: AI tagging, outfit suggestions, weather, households, notifications and wardrobe analytics, with no item caps and no license key. Wardrowbe Cloud adds a few features that depend on hosted infrastructure or business agreements: virtual try-on (GPU servers), partner store suggestions (agreements with stores and affiliate networks), Sign in with Apple and Google, receipt import, adding items from a text description, and achievements. The iOS and Android apps are not open source, but they can connect to a self-hosted server. When you self-host, you run and update the server yourself and supply your own AI endpoint, which determines tagging quality.

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