ahkamboh commited on
Commit
1a7ab23
·
verified ·
1 Parent(s): fdd10b2

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +106 -1
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