Spaces:
Runtime error
Runtime error
Update README.md
Browse files
README.md
CHANGED
|
@@ -9,5 +9,110 @@ app_file: app.py
|
|
| 9 |
pinned: false
|
| 10 |
license: mit
|
| 11 |
---
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 12 |
|
| 13 |
-
Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
|
|
|
|
| 9 |
pinned: false
|
| 10 |
license: mit
|
| 11 |
---
|
| 12 |
+
# Change-cloth-AI🐨
|
| 13 |
+
|
| 14 |
+
A virtual try-on system that uses AI to visualize how different clothing items would look on a person.
|
| 15 |
+
|
| 16 |
+
## Overview
|
| 17 |
+
|
| 18 |
+
Outfit Diffusion is an AI-powered virtual try-on system that allows users to:
|
| 19 |
+
- Upload a photo of a person (model image)
|
| 20 |
+
- Upload a photo of a clothing item
|
| 21 |
+
- Generate realistic visualizations of how the clothing would look on the person
|
| 22 |
+
|
| 23 |
+
## Features
|
| 24 |
+
|
| 25 |
+
- **Easy-to-use Interface**: Simple upload system for both model and garment images
|
| 26 |
+
- **Pre-loaded Examples**: Includes sample model and garment images for quick testing
|
| 27 |
+
- **Customizable Generation**: Adjust parameters like:
|
| 28 |
+
- Number of samples
|
| 29 |
+
- Number of steps
|
| 30 |
+
- Image scale
|
| 31 |
+
- Random seed
|
| 32 |
+
|
| 33 |
+
## How to Use
|
| 34 |
+
|
| 35 |
+
1. **Select or Upload Model Image**
|
| 36 |
+
- Choose from provided example models
|
| 37 |
+
- Or upload your own model image (person wearing clothes)
|
| 38 |
+
|
| 39 |
+
2. **Select or Upload Garment**
|
| 40 |
+
- Choose from provided example garments
|
| 41 |
+
- Or upload your own garment image
|
| 42 |
+
|
| 43 |
+
3. **Adjust Parameters (Optional)**
|
| 44 |
+
- Steps: Higher values give better quality but take longer
|
| 45 |
+
- Scale: Affects how closely the output follows the input
|
| 46 |
+
- Seed: Set for reproducible results
|
| 47 |
+
|
| 48 |
+
4. **Generate Output**
|
| 49 |
+
- Click "Generate Outfit" to create the visualization
|
| 50 |
+
- Wait for processing (may take a few moments)
|
| 51 |
+
|
| 52 |
+
## Technical Details
|
| 53 |
+
|
| 54 |
+
- Built using Gradio interface
|
| 55 |
+
- Powered by diffusion models
|
| 56 |
+
- SDK Version: 5.4.0
|
| 57 |
+
- Runs on Hugging Face Spaces
|
| 58 |
+
|
| 59 |
+
## Limitations
|
| 60 |
+
|
| 61 |
+
- Processing time depends on server load
|
| 62 |
+
- Free tier has usage quotas
|
| 63 |
+
- Best results with clear, front-facing photos
|
| 64 |
+
- Garment images should be on white/clear backgrounds
|
| 65 |
+
|
| 66 |
+
## Tips for Best Results
|
| 67 |
+
|
| 68 |
+
1. Use clear, well-lit photographs
|
| 69 |
+
2. Model should be in a natural, front-facing pose
|
| 70 |
+
3. Garment images should be isolated on clean backgrounds
|
| 71 |
+
4. Start with lower step counts (10-15) for quick tests
|
| 72 |
+
5. Increase steps for final, higher-quality results
|
| 73 |
+
|
| 74 |
+
## Error Handling
|
| 75 |
+
|
| 76 |
+
If you encounter quota errors:
|
| 77 |
+
- Wait a few minutes between attempts
|
| 78 |
+
- Try reducing the number of steps
|
| 79 |
+
- Consider signing up for a Hugging Face account for more quota
|
| 80 |
+
|
| 81 |
+
## Author
|
| 82 |
+
|
| 83 |
+
**Ali Hamza Kamboh (AHKamBoh)**
|
| 84 |
+
- LinkedIn: [Ali Hamza Kamboh](https://www.linkedin.com/in/ahkamboh/)
|
| 85 |
+
- GitHub: [@ahkamboh](https://github.com/ahkamboh)
|
| 86 |
+
|
| 87 |
+
## Credits
|
| 88 |
+
|
| 89 |
+
This project uses the Hugging Face Spaces infrastructure and is built on top of state-of-the-art diffusion models for virtual try-on applications.
|
| 90 |
+
|
| 91 |
+
## License
|
| 92 |
+
|
| 93 |
+
MIT License
|
| 94 |
+
|
| 95 |
+
Copyright (c) 2024 Ali Hamza Kamboh (AHKamBoh)
|
| 96 |
+
|
| 97 |
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
| 98 |
+
of this software and associated documentation files (the "Software"), to deal
|
| 99 |
+
in the Software without restriction, including without limitation the rights
|
| 100 |
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
| 101 |
+
copies of the Software, and to permit persons to whom the Software is
|
| 102 |
+
furnished to do so, subject to the following conditions:
|
| 103 |
+
|
| 104 |
+
The above copyright notice and this permission notice shall be included in all
|
| 105 |
+
copies or substantial portions of the Software.
|
| 106 |
+
|
| 107 |
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
| 108 |
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
| 109 |
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
| 110 |
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
| 111 |
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
| 112 |
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
| 113 |
+
SOFTWARE.
|
| 114 |
+
|
| 115 |
+
---
|
| 116 |
+
|
| 117 |
+
For more information about the configuration, visit: https://huggingface.co/docs/hub/spaces-config-reference
|
| 118 |
|
|
|