StableDesign2 / README.md
anbucur
Added functionality
4e4b650

A newer version of the Gradio SDK is available: 5.22.0

Upgrade
metadata
title: StableDesign
emoji: 🏆
colorFrom: yellow
colorTo: gray
sdk: gradio
sdk_version: 4.26.0
app_file: app.py
pinned: false
license: mit

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

Interior Design Assistant

An AI-powered interior design assistant that helps transform room photos with customizable design variations.

Features

  • Upload room photos and generate design variations
  • Customize room type, style, color schemes
  • Adjust floor and wall finishes
  • Add wall decorations (art, mirrors, sconces)
  • Control generation parameters (quality, creativity, etc.)
  • Save results to Google Drive
  • Production and test modes

Requirements

  • Python 3.8 or higher
  • CUDA-capable GPU with 8GB+ VRAM (recommended)
  • CPU-only mode supported but slower

Installation

  1. Clone the repository:
git clone [your-repo-url]
cd StableDesign2
  1. Create and activate a virtual environment:
python -m venv venv
source venv/bin/activate  # Linux/Mac
# or
.\venv\Scripts\activate  # Windows
  1. Install dependencies:
pip install -r requirements.txt
  1. Set up Google Drive integration (optional):
  • Create a project in Google Cloud Console
  • Enable the Google Drive API
  • Create OAuth 2.0 credentials
  • Download credentials and save as credentials.json in the project root

Usage

Production Mode

python app.py

Test Mode (for development)

python app.py --test

The interface will be available at http://localhost:7860

Configuration

Model Settings

  • Quality Steps: 20-100 (default: 50)
  • Design Freedom: 1-20 (default: 7.5)
  • Change Amount: 0.1-1.0 (default: 0.75)
  • Number of Variations: 1-4

Design Options

  • Room Types: 16 options
  • Design Styles: 20 options
  • Color Schemes: 20 options
  • Floor & Wall Options: Multiple materials, colors, patterns
  • Wall Decorations: Art, mirrors, sconces, shelves, plants

Error Handling

The application includes comprehensive error handling:

  • Input validation
  • Model generation fallbacks
  • Google Drive upload retries
  • Detailed error logging

Development

Running Tests

python -m pytest

Code Style

black .
flake8
isort .

License

[Your License]

Credits