How ainan-ahmed/wardrobeassistant works
wardrobeAssistant is a local-first wardrobe manager: users add garment photos, which are cataloged and searchable, then browse inventory, request weather- and occasion-aware outfit suggestions, chat with Aura, and review wardrobe analytics. The graph covers the UI-to-API paths, ingestion and retrieval stages, AI agents, and persisted state. Source excerpts establish most backend calls; some README-described capabilities (including browser geolocation and weather lookup) are shown as documented but their implementation paths were not sampled.
Main entry points: App.tsx App shell · items.py Wardrobe endpoints · outfits.py Outfit endpoints · chat.py Chat endpoints
Components 19
Wardrobe UI
- App shell
frontend/src/App.tsx - Inventory UI
frontend/src/domains/wardrobe/components/ClosetInventory.tsx - Photo ingestion
frontend/src/domains/wardrobe/components/ApparelIngestion.tsx - Outfit planner
frontend/src/pages/OutfitsTab.tsx - Style assistant
frontend/src/pages/AssistantTab.tsx - Closet analytics
frontend/src/pages/AnalyticsTab.tsx - Home dashboard
frontend/src/pages/HomeTab.tsx
Backend API
- FastAPI server
backend/main.py - Wardrobe endpoints
backend/routers/items.py - Outfit endpoints
backend/routers/outfits.py - Chat endpoints
backend/routers/chat.py
AI Services
- Garment cataloging
backend/services/vision_pipeline.py - Semantic retrieval
backend/services/llm_engine.py - Stylist and outfit agents
backend/services/agents.py - Conversation memory
backend/services/memory.py
Wardrobe State
- Domain records
backend/models.py - PostgreSQL + pgvector
backend/database.py
Other components
- Wardrobe user
- Open-Meteo weather
Connections 28
- Wardrobe user → App shell: uses
frontend/src/App.tsx - App shell → FastAPI server: requests
- App shell → Inventory UI: renders
frontend/src/App.tsx - App shell → Photo ingestion: renders
- App shell → Outfit planner: renders
frontend/src/App.tsx - App shell → Style assistant: renders
frontend/src/App.tsx - App shell → Closet analytics: renders
frontend/src/App.tsx - App shell → Home dashboard: renders
frontend/src/App.tsx - Inventory UI → Wardrobe endpoints: loads items
- Photo ingestion → App shell: submits photos
- App shell → Wardrobe endpoints: uploads photos
frontend/src/App.tsx - Outfit planner → Outfit endpoints: requests looks
- Outfit endpoints → Semantic retrieval: retrieves matches
backend/routers/outfits.py - Outfit endpoints → Stylist and outfit agents: requests recommendation
backend/routers/outfits.py - Open-Meteo weather → Outfit planner: supplies forecast
README.md - Style assistant → Chat endpoints: sends messages
- Chat endpoints → Stylist and outfit agents: runs stylist
backend/routers/chat.py - Chat endpoints → Conversation memory: schedules consolidation
backend/routers/chat.py - Wardrobe endpoints → Garment cataloging: processes garment
backend/routers/items.py - Wardrobe endpoints → Semantic retrieval: embeds search
backend/routers/items.py - Garment cataloging → Domain records: creates item
backend/services/vision_pipeline.py - Semantic retrieval → Domain records: queries items
backend/services/llm_engine.py - Stylist and outfit agents → Domain records: reads closet
backend/services/agents.py - Conversation memory → Domain records: updates profile
backend/services/memory.py - Wardrobe endpoints → PostgreSQL + pgvector: persists items
backend/routers/items.py - Outfit endpoints → PostgreSQL + pgvector: persists outfits
backend/routers/outfits.py - Chat endpoints → PostgreSQL + pgvector: persists messages
backend/routers/chat.py - Closet analytics → Inventory UI: summarizes closet