multi_image / README.md
mrbeniwal's picture
Update README with Hugging Face Space metadata and formatting
9a4e7bf
metadata
title: Multi Image Generator
emoji: 🎨
colorFrom: purple
colorTo: blue
sdk: docker
app_file: app.py
pinned: false

Multi Image Generator

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.

✨ Features

  • πŸ€– Multi-Provider Support - Use OpenAI, Google Generative AI, or Qwen
  • 🧠 Smart Model Selection - Automatically route to the best available provider
  • ⚑ Real-time Generation - Watch your images come to life
  • πŸ“œ Image History - Keep track of all your generated images
  • πŸŒ“ Dark/Light Mode - Comfortable viewing in any lighting
  • πŸ” Secure API Keys - Manage your API keys privately through settings

🎯 Supported Providers

Provider Model Features
OpenAI DALL-E 3 High-quality, detailed images
Google Imagen 2 Fast generation, excellent quality
Qwen Qwen Image Gen Cost-effective, good quality

πŸš€ Quick Start

  1. Visit the Space and open the application
  2. Add API Keys - Click settings and add your API keys for providers you want to use
  3. Generate Images - Enter your prompt and watch the magic happen!

Getting API Keys

πŸ’» Local Development

# Install dependencies
npm install

# Run development server
npm run dev
# App available at http://localhost:9002

# Build for production
npm run build

# Start production server
npm start

πŸ› οΈ Technologies

  • Frontend: Next.js 15, React 19, TypeScript
  • Styling: Tailwind CSS, Radix UI
  • AI: Genkit AI, Google Generative AI SDK
  • Backend: Next.js API Routes
  • UI Components: shadcn/ui

πŸ“ How It Works

  1. Prompt Enhancement - Your prompt is automatically improved for better results
  2. Provider Selection - The app intelligently selects the best available provider
  3. Image Generation - Request sent to the selected provider
  4. Display & History - Generated images shown with automatic history tracking

🐳 Docker Deployment

This project is configured to run on Hugging Face Spaces using Docker:

# The Dockerfile handles:
- Node.js environment setup
- Dependency installation
- Next.js build
- Production server startup on port 7860

βš™οΈ Configuration

All configuration is handled through the UI:

  • API keys are stored locally in your browser
  • No sensitive data is stored on the server
  • Settings are managed via the settings panel

πŸ“œ License

MIT License - feel free to use this project for personal or commercial purposes.

🀝 Contributing

Have ideas to improve Multi Image Generator? Feel free to:

  • Report issues
  • Suggest features
  • Submit pull requests

πŸ“§ Support

For issues or questions about using the app, please check the settings panel for API key configuration help.