update readme
Browse files
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! π¨β¨
|