Spaces:
Running
Running
| 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: | |
| ```bash | |
| git clone [your-repo-url] | |
| cd StableDesign2 | |
| ``` | |
| 2. Create and activate a virtual environment: | |
| ```bash | |
| python -m venv venv | |
| source venv/bin/activate # Linux/Mac | |
| # or | |
| .\venv\Scripts\activate # Windows | |
| ``` | |
| 3. Install dependencies: | |
| ```bash | |
| pip install -r requirements.txt | |
| ``` | |
| 4. 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 | |
| ```bash | |
| python app.py | |
| ``` | |
| ### Test Mode (for development) | |
| ```bash | |
| 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 | |
| ```bash | |
| python -m pytest | |
| ``` | |
| ### Code Style | |
| ```bash | |
| black . | |
| flake8 | |
| isort . | |
| ``` | |
| ## License | |
| [Your License] | |
| ## Credits | |
| - Built with [Gradio](https://gradio.app/) | |
| - Powered by [Stable Diffusion](https://stability.ai/) | |