Akjava commited on
Commit
e2ed9b1
Β·
1 Parent(s): 957b270

update readme

Browse files
Files changed (1) hide show
  1. README.md +151 -0
README.md CHANGED
@@ -23,3 +23,154 @@ I shared my project on X:
23
  ## Demo Video
24
  The demo video is attached to the X post above. You can watch it directly here:
25
  [Watch Demo Video on X](https://x.com/Akihito_AI/status/1994659192087744988)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
23
  ## Demo Video
24
  The demo video is attached to the X post above. You can watch it directly here:
25
  [Watch Demo Video on X](https://x.com/Akihito_AI/status/1994659192087744988)
26
+
27
+
28
+ ## πŸš€ Quick Start
29
+
30
+ 1. **Open the App**: Launch the Gradio application
31
+ 2. **Fill in Settings**: Configure your button design preferences
32
+ 3. **Generate**: Click the "Generate Buttons" button
33
+ 4. **Download**: Save your generated button images
34
+
35
+ ## πŸ“ Basic Settings
36
+
37
+ ### Button Text
38
+ - Enter the text you want to display on your buttons
39
+ - You can enter multiple texts separated by commas (e.g., "Start, OK, Cancel")
40
+ - Supports up to 4 different button texts
41
+
42
+ ### Detail Prompt
43
+ - Describe the design style you want (e.g., "Neon cyberpunk", "Minimal elegant", "Wood texture")
44
+ - This controls the overall aesthetic and visual elements
45
+ - Examples:
46
+ - "Neon glowing cyberpunk, blue/purple gradient"
47
+ - "Luxury gold texture, minimal elegant, serif"
48
+ - "Wood texture, steel rim, fantasy game style"
49
+
50
+ ## 🎨 Style & Layout
51
+
52
+ ### Shape Options
53
+ - **Box**: Sharp rectangular corners
54
+ - **Rounded**: Soft rounded corners (default)
55
+ - **Oval**: Elliptical shape
56
+ - **Free**: Organic freeform shape
57
+
58
+ ### Layout Options
59
+ - **Horizontal 3**: 3 buttons arranged in horizontal rows (top, middle, bottom)
60
+ - **Vertical 2**: 2 tall buttons arranged side by side (left, right)
61
+ - **Box 2x2**: 4 buttons in a 2x2 grid (left-top, right-top, left-bottom, right-bottom)
62
+
63
+ ### Background Options
64
+ - **Natural**: Natural background with subtle textures and ambient lighting
65
+ - **White**: Plain white background
66
+ - **Black**: Plain black background
67
+
68
+ ## βš™οΈ Advanced Settings
69
+
70
+ ### Seed
71
+ - Controls the randomness of the generation
72
+ - Range: 0 to 2,147,483,647
73
+ - Use the same seed value to reproduce identical results
74
+
75
+ ### Randomize Seed
76
+ - Toggle to enable/disable random seed generation
77
+ - When enabled, each generation uses a different random seed
78
+
79
+ ### Aspect Ratio
80
+ - **1:1**: Square format (1024x1024) - Recommended
81
+ - **16:9**: Wide format (1280x720)
82
+ - **9:16**: Portrait format (720x1280)
83
+
84
+ ### Guidance Scale
85
+ - Controls how closely the AI follows your prompt
86
+ - Default: 1.0 (recommended)
87
+ - Range: 1.0 to 5.0
88
+
89
+ ### Steps
90
+ - Number of inference steps for image generation
91
+ - Default: 8 (recommended)
92
+ - Range: 4 to 28
93
+ - Higher values may improve quality but increase generation time
94
+
95
+ ## 🎯 Quick Presets
96
+
97
+ Use the example presets to get started quickly:
98
+
99
+ ### 1. Cyberpunk Start Button
100
+ - **Text**: "Start, Option, Exit"
101
+ - **Style**: Neon glowing cyberpunk, blue/purple gradient
102
+ - **Shape**: Box
103
+ - **Layout**: Horizontal 3
104
+ - **Background**: Black
105
+
106
+ ### 2. Luxury Buy Button
107
+ - **Text**: "Buy"
108
+ - **Style**: Luxury gold texture, minimal elegant, serif
109
+ - **Shape**: Rounded
110
+ - **Layout**: Vertical 2
111
+ - **Background**: White
112
+
113
+ ### 3. Fantasy RPG Buttons
114
+ - **Text**: "RPG, R, P, G"
115
+ - **Style**: Wood texture, steel rim, fantasy game style
116
+ - **Shape**: Free
117
+ - **Layout**: Box 2x2
118
+ - **Background**: Natural
119
+
120
+ ## πŸ’‘ Tips for Best Results
121
+
122
+ 1. **Be Specific**: The more detailed your prompt, the better the results
123
+ 2. **Use References**: Mention styles like "minimal", "cyberpunk", "vintage", etc.
124
+ 3. **Experiment**: Try different combinations of settings
125
+ 4. **Save Seeds**: Note down seeds for designs you like to reproduce them later
126
+ 5. **Background Matters**: Choose background that complements your design
127
+
128
+ ## πŸ”§ Technical Details
129
+
130
+ - **Model**: Z-Image-Turbo (Zero-GPU)
131
+ - **Resolution**: Up to 1024x1024 pixels
132
+ - **Format**: WebP output
133
+ - **Platform**: Gradio web interface
134
+
135
+ ## 🌐 MCP Integration
136
+
137
+ This app supports MCP (Model Context Protocol) for enhanced functionality:
138
+ - Zero-GPU inference on Hugging Face Spaces
139
+ - Header authorization for API access
140
+ - Shareable links for collaboration
141
+
142
+ ## πŸ“Έ Downloading Results
143
+
144
+ 1. Generated images appear in the output panel
145
+ 2. Right-click on the image to save
146
+ 3. Images are automatically saved in WebP format
147
+ 4. You can convert to other formats using image editors if needed
148
+
149
+ ## πŸ€” Troubleshooting
150
+
151
+ ### Generation Failed
152
+ - Check your internet connection
153
+ - Try reducing the number of inference steps
154
+ - Verify your HF_TOKEN if using private models
155
+
156
+ ### Poor Quality Results
157
+ - Increase the number of inference steps (up to 28)
158
+ - Make your prompt more specific
159
+ - Try different aspect ratios
160
+
161
+ ### Slow Generation
162
+ - Use fewer inference steps (4-12)
163
+ - Use 1:1 aspect ratio for faster processing
164
+ - Close other browser tabs to free up resources
165
+
166
+ ## 🎨 Design Inspiration
167
+
168
+ Try these popular styles:
169
+ - **Minimal**: Clean, simple, flat design
170
+ - **Neon**: Cyberpunk with glowing effects
171
+ - **Vintage**: Retro 80s/90s aesthetics
172
+ - **Luxury**: Gold, black, premium materials
173
+ - **Fantasy**: Medieval, wood, magical themes
174
+ - **Sci-Fi**: Futuristic, metallic, high-tech
175
+
176
+ Enjoy creating your button designs! 🎨✨