Spaces:
Runtime error
Runtime error
Update README with Hugging Face Space metadata and formatting
Browse files
README.md
CHANGED
|
@@ -1,86 +1,108 @@
|
|
| 1 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 2 |
|
| 3 |
-
|
| 4 |
|
| 5 |
-
|
| 6 |
|
| 7 |
-
|
| 8 |
-
- Smart model selection based on availability
|
| 9 |
-
- Real-time image generation with progress tracking
|
| 10 |
-
- History management for generated images
|
| 11 |
-
- Dark/Light theme support
|
| 12 |
-
- API key management through settings panel
|
| 13 |
|
| 14 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 15 |
|
| 16 |
-
|
| 17 |
-
- **Google Generative AI** - Imagen
|
| 18 |
-
- **Qwen** - Qwen Image Generation
|
| 19 |
|
| 20 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
| 21 |
|
| 22 |
-
|
| 23 |
|
| 24 |
-
|
| 25 |
-
- API keys for
|
|
|
|
| 26 |
|
| 27 |
-
###
|
| 28 |
|
| 29 |
-
|
| 30 |
-
|
| 31 |
-
|
| 32 |
-
npm install
|
| 33 |
-
```
|
| 34 |
-
|
| 35 |
-
3. Set up environment variables:
|
| 36 |
-
```bash
|
| 37 |
-
cp .env.example .env.local
|
| 38 |
-
```
|
| 39 |
-
|
| 40 |
-
4. Add your API keys to the settings panel in the app
|
| 41 |
|
| 42 |
-
|
| 43 |
|
| 44 |
```bash
|
| 45 |
-
|
| 46 |
-
|
| 47 |
-
|
| 48 |
-
The app will be available at `http://localhost:9002`
|
| 49 |
|
| 50 |
-
|
|
|
|
|
|
|
| 51 |
|
| 52 |
-
|
| 53 |
npm run build
|
|
|
|
|
|
|
| 54 |
npm start
|
| 55 |
```
|
| 56 |
|
| 57 |
-
##
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 58 |
|
| 59 |
-
|
| 60 |
|
| 61 |
-
|
|
|
|
|
|
|
|
|
|
| 62 |
|
| 63 |
-
|
|
|
|
|
|
|
| 64 |
|
| 65 |
-
1. Create a new Space on Hugging Face (Docker runtime)
|
| 66 |
-
2. Clone this repository into the space
|
| 67 |
-
3. Push to the space:
|
| 68 |
```bash
|
| 69 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
| 70 |
```
|
| 71 |
|
| 72 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 73 |
|
| 74 |
-
##
|
| 75 |
|
| 76 |
-
|
| 77 |
-
-
|
| 78 |
-
-
|
| 79 |
-
-
|
| 80 |
-
- Genkit AI
|
| 81 |
-
- Firebase (for features)
|
| 82 |
-
- Radix UI components
|
| 83 |
|
| 84 |
-
##
|
| 85 |
|
| 86 |
-
|
|
|
|
| 1 |
+
---
|
| 2 |
+
title: Multi Image Generator
|
| 3 |
+
emoji: π¨
|
| 4 |
+
colorFrom: purple
|
| 5 |
+
colorTo: blue
|
| 6 |
+
sdk: docker
|
| 7 |
+
app_file: app.py
|
| 8 |
+
pinned: false
|
| 9 |
+
---
|
| 10 |
|
| 11 |
+
# Multi Image Generator
|
| 12 |
|
| 13 |
+
A powerful Next.js web application for generating images using multiple AI providers. Generate stunning images with OpenAI DALL-E 3, Google Generative AI, or Qwen - all from one unified interface.
|
| 14 |
|
| 15 |
+
## β¨ Features
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 16 |
|
| 17 |
+
- π€ **Multi-Provider Support** - Use OpenAI, Google Generative AI, or Qwen
|
| 18 |
+
- π§ **Smart Model Selection** - Automatically route to the best available provider
|
| 19 |
+
- β‘ **Real-time Generation** - Watch your images come to life
|
| 20 |
+
- π **Image History** - Keep track of all your generated images
|
| 21 |
+
- π **Dark/Light Mode** - Comfortable viewing in any lighting
|
| 22 |
+
- π **Secure API Keys** - Manage your API keys privately through settings
|
| 23 |
|
| 24 |
+
## π― Supported Providers
|
|
|
|
|
|
|
| 25 |
|
| 26 |
+
| Provider | Model | Features |
|
| 27 |
+
|----------|-------|----------|
|
| 28 |
+
| **OpenAI** | DALL-E 3 | High-quality, detailed images |
|
| 29 |
+
| **Google** | Imagen 2 | Fast generation, excellent quality |
|
| 30 |
+
| **Qwen** | Qwen Image Gen | Cost-effective, good quality |
|
| 31 |
|
| 32 |
+
## π Quick Start
|
| 33 |
|
| 34 |
+
1. **Visit the Space** and open the application
|
| 35 |
+
2. **Add API Keys** - Click settings and add your API keys for providers you want to use
|
| 36 |
+
3. **Generate Images** - Enter your prompt and watch the magic happen!
|
| 37 |
|
| 38 |
+
### Getting API Keys
|
| 39 |
|
| 40 |
+
- **OpenAI**: https://platform.openai.com/api-keys
|
| 41 |
+
- **Google**: https://ai.google.dev
|
| 42 |
+
- **Qwen**: https://dashscope.aliyun.com
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 43 |
|
| 44 |
+
## π» Local Development
|
| 45 |
|
| 46 |
```bash
|
| 47 |
+
# Install dependencies
|
| 48 |
+
npm install
|
|
|
|
|
|
|
| 49 |
|
| 50 |
+
# Run development server
|
| 51 |
+
npm run dev
|
| 52 |
+
# App available at http://localhost:9002
|
| 53 |
|
| 54 |
+
# Build for production
|
| 55 |
npm run build
|
| 56 |
+
|
| 57 |
+
# Start production server
|
| 58 |
npm start
|
| 59 |
```
|
| 60 |
|
| 61 |
+
## π οΈ Technologies
|
| 62 |
+
|
| 63 |
+
- **Frontend**: Next.js 15, React 19, TypeScript
|
| 64 |
+
- **Styling**: Tailwind CSS, Radix UI
|
| 65 |
+
- **AI**: Genkit AI, Google Generative AI SDK
|
| 66 |
+
- **Backend**: Next.js API Routes
|
| 67 |
+
- **UI Components**: shadcn/ui
|
| 68 |
|
| 69 |
+
## π How It Works
|
| 70 |
|
| 71 |
+
1. **Prompt Enhancement** - Your prompt is automatically improved for better results
|
| 72 |
+
2. **Provider Selection** - The app intelligently selects the best available provider
|
| 73 |
+
3. **Image Generation** - Request sent to the selected provider
|
| 74 |
+
4. **Display & History** - Generated images shown with automatic history tracking
|
| 75 |
|
| 76 |
+
## π³ Docker Deployment
|
| 77 |
+
|
| 78 |
+
This project is configured to run on Hugging Face Spaces using Docker:
|
| 79 |
|
|
|
|
|
|
|
|
|
|
| 80 |
```bash
|
| 81 |
+
# The Dockerfile handles:
|
| 82 |
+
- Node.js environment setup
|
| 83 |
+
- Dependency installation
|
| 84 |
+
- Next.js build
|
| 85 |
+
- Production server startup on port 7860
|
| 86 |
```
|
| 87 |
|
| 88 |
+
## βοΈ Configuration
|
| 89 |
+
|
| 90 |
+
All configuration is handled through the UI:
|
| 91 |
+
- API keys are stored locally in your browser
|
| 92 |
+
- No sensitive data is stored on the server
|
| 93 |
+
- Settings are managed via the settings panel
|
| 94 |
+
|
| 95 |
+
## π License
|
| 96 |
+
|
| 97 |
+
MIT License - feel free to use this project for personal or commercial purposes.
|
| 98 |
|
| 99 |
+
## π€ Contributing
|
| 100 |
|
| 101 |
+
Have ideas to improve Multi Image Generator? Feel free to:
|
| 102 |
+
- Report issues
|
| 103 |
+
- Suggest features
|
| 104 |
+
- Submit pull requests
|
|
|
|
|
|
|
|
|
|
| 105 |
|
| 106 |
+
## π§ Support
|
| 107 |
|
| 108 |
+
For issues or questions about using the app, please check the settings panel for API key configuration help.
|