Spaces:
Running
Running
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 |
|
|