Skip to content

Kush05Bhardwaj/Artistry-Redesign

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

18 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Artistry 🎨

AI-Powered Interior Design Platform - Now with 70-80% Faster Performance! ⚑

Transform room photos into professional designs using state-of-the-art AI. Upload once, get object detection, segmentation, design advice, and photorealistic redesignsβ€”all automatically.

React FastAPI Python PyTorch License Optimized

✨ Features

  • πŸ” Object Detection - Identify furniture and room elements with YOLOv8 (80% faster!)
  • βœ‚οΈ Image Segmentation - Isolate design components with MobileSAM (37% less memory)
  • πŸ’‘ AI Design Advice - Get grounded, actionable recommendations based on detected elements
  • 🎨 Design Generation - Create photorealistic redesigns with Stable Diffusion (37% less VRAM)
  • πŸ—οΈ Structure Preservation - Maintains original layout, furniture positions, and camera angle
  • ⚑ Full Workflow - Process through all services automatically (30-60s)
  • πŸ’° Cost Estimation - India-specific pricing with DIY vs Professional comparison (NEW!)
  • πŸ”¨ DIY Guidance - Step-by-step instructions for self-implementation (NEW!)
  • πŸ’Ύ Save & Share - User authentication, design history, and social sharing (NEW!)
  • πŸ›’ Shopping Integration - Smart product matching with local brands (Amazon, Flipkart, Urban Ladder)

πŸš€ Performance Improvements (NEW!)

Metric Before After Improvement
Detection Speed 3-5s 0.5-1s 80%+ faster ⚑
Gateway Latency 100ms 60ms 40% faster ⚑
GPU Memory (Detect) 3GB 2GB 33% savings πŸ’Ύ
GPU Memory (Generate) 8GB 5GB 37% savings πŸ’Ύ

See Backend Optimization Guide for details.

πŸš€ Quick Start

Prerequisites

  • Python 3.10+
  • Node.js 16+
  • MongoDB Atlas account (free tier)
  • 15GB disk space, 8GB RAM (reduced from 16GB!)

Backend Setup (Optimized)

# 1. Clone repository
git clone https://github.com/Kush05Bhardwaj/Artistry-Redesign.git
cd Artistry-Redesign\artistry-backend

# 2. Create virtual environments and install dependencies
.\manage-dependencies.ps1 -Install

# 3. Start all optimized services
.\start-optimized-services.ps1

# 4. Verify optimizations are active
.\check-optimizations.ps1

Services will start on:

Frontend Setup

cd ../frontend npm install

4. Configure Environment

Create frontend/.env

VITE_GATEWAY_URL=http://localhost:8000 VITE_DETECT_URL=http://localhost:8001 VITE_SEGMENT_URL=http://localhost:8002 VITE_ADVISE_URL=http://localhost:8003 VITE_GENERATE_URL=http://localhost:8004


### Running the Application

**Option 1: Automated (Windows)**
```powershell
# Terminal 1 - Start all backend services
cd artistry-backend
.\start_all_services.ps1

# Terminal 2 - Start frontend
cd frontend
npm run dev

Option 2: Manual

# Start each service in separate terminals
cd artistry-backend/gateway && uvicorn app.main:app --port 8000
cd artistry-backend/detect && uvicorn app.main:app --port 8001
cd artistry-backend/segment && uvicorn app.main:app --port 8002
cd artistry-backend/advise && uvicorn app.main:app --port 8003
cd artistry-backend/generate && uvicorn app.main:app --port 8004

# Start frontend
cd frontend && npm run dev

Access: http://localhost:5173

πŸ“– Usage

Full Workflow (Recommended)

  1. Navigate to http://localhost:5173/workflow
  2. Upload a room photo
  3. Click "Start Complete Workflow"
  4. Wait ~30-60 seconds
  5. View all results: detection, segmentation, advice, and generated design

Individual Services

Access services separately via navigation menu:

  • /detect - Object detection only
  • /segment - Image segmentation only
  • /advise - Design advice only
  • /generate - Design generation only

πŸ—οΈ Architecture

Pipeline Overview

Correct High-Level Pipeline:

User Image
    ↓
Room understanding (objects + layout + size + lighting)
    ↓
Style intent (modern, minimal, boho, etc.)
    ↓
Image-conditioned generation (img2img with ControlNet)
    ↓
Final redesigned image (same room, new style)

Microservices Architecture

Frontend (React + Vite)
       ↓
Gateway Service (Port 8000)
       ↓
β”Œβ”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
Detect  Segment  Advise  Generate
:8001    :8002   :8003     :8004

5 Microservices:

  • Gateway (orchestration + MongoDB)
  • Detect (YOLOv8 - room understanding)
  • Segment (MobileSAM - mask generation)
  • Advise (Vision-LLM - structured recommendations)
  • Generate (Stable Diffusion img2img + ControlNet - layout-preserving redesign)

Key Architectural Principles

  1. img2img, not text2img - Original image guides generation
  2. ControlNet integration - Canny/Depth maps preserve structure
  3. Structured prompts - Explicit layout preservation instructions
  4. Grounded recommendations - LLM uses detection data (room_type, objects, lighting)

πŸ“š Documentation

For detailed guides, API reference, and troubleshooting:

πŸ“˜ Complete Documentation β†’

Quick Links:

πŸ§ͺ Testing

# Check all services
cd artistry-backend
.\test_services.ps1

# Test individual service
curl http://localhost:8000/health

πŸ› Common Issues

Issue Solution
Port already in use taskkill /PID <PID> /F (Windows) or kill -9 <PID> (Unix)
Module not found Activate venv: .\venv\Scripts\activate
CORS error Check allow_origins in service main.py
MongoDB connection Whitelist IP in MongoDB Atlas

Full troubleshooting guide: docs/troubleshooting/

πŸ“Š Performance

Workflow CPU GPU (RTX 3060+)
Full Workflow 40-60s 12-15s
Detection 2-3s 0.5s
Segmentation 3-5s 1s
Advice 5-8s 2s
Generation 30-40s 8s

πŸ—ΊοΈ Roadmap

Current (v2.0)

βœ… Full workflow automation
βœ… 5 microservices
βœ… MongoDB integration
βœ… Real-time progress tracking

Upcoming (v2.1 - Q1 2026)

  • User authentication
  • Design history & saving
  • Before/after comparison
  • Room templates & style presets

Full Roadmap β†’

🀝 Contributing

Contributions welcome! See our Contributing Guide.

1. Fork the repository
2. Create feature branch: git checkout -b feature/amazing
3. Commit changes: git commit -m 'Add feature'
4. Push: git push origin feature/amazing
5. Open Pull Request

πŸ“ License

MIT License - see LICENSE file.

Third-party models: Review individual licenses for YOLOv8, Stable Diffusion, SAM.

πŸ‘₯ Team

Kushagra Bhardwaj - @Kush05Bhardwaj Sahdev Sharma - @SAHDEVSHARMA

πŸ“ž Support

πŸ™ Acknowledgments


View Full Documentation | Backend Details | API Docs

About

An AI-powered interior design platform that transforms room photos into professional design visualizations. Upload a photo of your space, and let our AI models analyze, segment, advise, and generate stunning redesigns.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors