Upload README.md with huggingface_hub
Browse files
README.md
ADDED
|
@@ -0,0 +1,72 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
---
|
| 2 |
+
title: AI Interior Design - Structure Preserving
|
| 3 |
+
emoji: 🏠
|
| 4 |
+
colorFrom: blue
|
| 5 |
+
colorTo: green
|
| 6 |
+
sdk: gradio
|
| 7 |
+
sdk_version: 4.44.1
|
| 8 |
+
app_file: app.py
|
| 9 |
+
pinned: false
|
| 10 |
+
license: apache-2.0
|
| 11 |
+
---
|
| 12 |
+
|
| 13 |
+
# 🏠 AI Interior Design - Structure Preserving
|
| 14 |
+
|
| 15 |
+
Transform your room's style while **preserving the original structure, layout, and architectural elements**.
|
| 16 |
+
|
| 17 |
+
## 🔧 Key Features
|
| 18 |
+
|
| 19 |
+
This app uses advanced **image-to-image** and **ControlNet** models that can:
|
| 20 |
+
- ✅ Maintain room dimensions and proportions
|
| 21 |
+
- ✅ Preserve architectural features (windows, doors, walls)
|
| 22 |
+
- ✅ Keep furniture placement and spatial relationships
|
| 23 |
+
- ✅ Transform only the **style, colors, and materials**
|
| 24 |
+
|
| 25 |
+
## 🤖 Technology Stack
|
| 26 |
+
|
| 27 |
+
The app leverages multiple state-of-the-art models in priority order:
|
| 28 |
+
|
| 29 |
+
1. **FLUX.1-dev ControlNet Union Pro** - Advanced ControlNet with multiple control types
|
| 30 |
+
2. **ControlNet Room Segmentation** - Specialized for interior design
|
| 31 |
+
3. **FLUX.1 ControlNet Union** - High-quality structure preservation
|
| 32 |
+
4. **Stable Diffusion Depth Img2Img** - Uses depth information
|
| 33 |
+
5. **Stable Diffusion v1.5 Img2Img** - Reliable transformation
|
| 34 |
+
6. **FLUX.1-dev** - General purpose fallback
|
| 35 |
+
|
| 36 |
+
## 🎨 Style Presets
|
| 37 |
+
|
| 38 |
+
- **Modern Minimalist** - Clean lines, neutral colors, natural light
|
| 39 |
+
- **Luxury Contemporary** - High-end materials, elegant finishes
|
| 40 |
+
- **Scandinavian Style** - Light wood, cozy atmosphere, hygge concept
|
| 41 |
+
- **Industrial Chic** - Exposed brick, metal fixtures, urban aesthetic
|
| 42 |
+
- **Cozy Traditional** - Warm colors, classic patterns, timeless design
|
| 43 |
+
|
| 44 |
+
## 📋 How to Use
|
| 45 |
+
|
| 46 |
+
1. **Upload** your room photo
|
| 47 |
+
2. **Choose** a style preset or add custom prompt
|
| 48 |
+
3. **Adjust** transformation strength (lower = more preservation)
|
| 49 |
+
4. **Generate** your transformed design!
|
| 50 |
+
|
| 51 |
+
## 💡 Tips for Best Results
|
| 52 |
+
|
| 53 |
+
- Use well-lit, clear photos of rooms
|
| 54 |
+
- Avoid blurry or dark images
|
| 55 |
+
- Lower strength values preserve more of the original structure
|
| 56 |
+
- Try different style presets to find your favorite
|
| 57 |
+
|
| 58 |
+
## 🔧 Technical Implementation
|
| 59 |
+
|
| 60 |
+
This application uses:
|
| 61 |
+
- **Image-to-image** transformation for style transfer
|
| 62 |
+
- **ControlNet** technology for structure preservation
|
| 63 |
+
- **Smart fallback system** across multiple models
|
| 64 |
+
- **Enhanced prompting** with architectural preservation keywords
|
| 65 |
+
- **Base64 image encoding** for API compatibility
|
| 66 |
+
- **Retry logic** with exponential backoff
|
| 67 |
+
|
| 68 |
+
The models are specifically chosen and configured for their ability to preserve room layout and architectural elements while transforming aesthetic style.
|
| 69 |
+
|
| 70 |
+
---
|
| 71 |
+
|
| 72 |
+
Built with ❤️ using Gradio and Hugging Face Transformers
|