mirror of https://github.com/yusufipk/imagen-openrouter.git synced 2026-09-11 10:36:07 +00:00

Files

T

Yusuf İpek 45f09260f9 feat: Initial release of Imagen - AI Image Generation Tool

A client-side AI image generation tool using OpenRouter API.

Features:
- Multi-model support (Gemini, GPT-5, Flux 2, Seedream, Riverflow)
- Unlimited reference image uploads with drag & drop
- IndexedDB storage for persistent image gallery
- Adjustable resolution (1K/2K/4K) and aspect ratios
- Batch generation (up to 8 images)
- Custom styled dropdown for model selection
- Gallery with delete functionality on hover
- Full image modal with metadata and recreate option
- XSS protection with input sanitization

Tech Stack:
- Pure HTML/CSS/JavaScript (no dependencies)
- IndexedDB for image persistence
- OpenRouter API integration

License: GPL-3.0

2026-01-20 22:16:37 +03:00

3.3 KiB

Raw Blame History

Imagen - AI Image Generation Tool

A powerful client-side AI image generation tool using OpenRouter API. Generate thumbnails, artwork, and creative images with multiple state-of-the-art models.

✨ Features

🎨 Multi-Model Support

Gemini 2.5 Flash Image - Google's fast image generation
Gemini 2.5 Flash (Preview) - Preview version with latest features
Gemini 3 Pro (Preview) - Advanced model, up to 14 reference images
GPT-5 Image - OpenAI's latest image model
GPT-5 Image Mini - Faster, smaller GPT-5 variant
Flux 2 Pro / Max / Flex / Klein - Black Forest Labs models
Seedream 4.5 - ByteDance's image model
Riverflow V2 - Fast/Standard/Max variants

📐 Flexible Output Options

Resolution: 1K, 2K, 4K (Gemini models)
Aspect Ratios: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2
Batch Generation: Up to 8 images at once

🖼️ Reference Image Support

Upload unlimited reference images
Drag & drop support
Use generated images as references
Click X to remove individual references

💾 Persistent Storage

IndexedDB storage
Store hundreds of images
Images persist across browser sessions

🎯 Gallery Features

View all generated images
Delete individual images (hover to reveal 🗑️ button)
Click any image for full view + metadata
Clear entire gallery option

♻️ Recreate Feature

Click any image to restore its original settings
Instantly iterate on previous generations

🚀 Quick Start

Clone this repository

Start a local server:

python3 -m http.server 8080
# or
npx serve .

Open http://localhost:8080
Enter your OpenRouter API key
Write a prompt and click Generate!

🔑 Getting an OpenRouter API Key

Go to OpenRouter
Create an account
Navigate to Keys section
Create a new API key
Copy and paste it into the tool

🔒 Privacy & Security

This is a 100% client-side application:

✅ API keys are stored in YOUR browser only
✅ Generated images are stored in YOUR browser only (IndexedDB)
✅ No data is sent to any server except OpenRouter API
✅ Safe to deploy as a static website

⌨️ Keyboard Shortcuts

Shortcut	Action
`Ctrl + Enter`	Generate images
`Escape`	Close image modal

🛠️ Tech Stack

Frontend: Pure HTML/CSS/JavaScript (no dependencies)
API: OpenRouter for model access
Storage: IndexedDB for image persistence
Styling: Custom CSS with CSS variables

📁 Project Structure

imagen/
├── index.html      # Main UI structure
├── styles.css      # Premium dark theme styling
├── app.js          # Core logic + API integration
└── README.md       # This file

📜 License

This project is licensed under the GNU General Public License v3.0 (GPL-3.0).

You are free to:

✅ Use this software for any purpose
✅ Study how the software works and modify it
✅ Distribute copies of the software
✅ Distribute modified versions

Under the condition that:

📋 You include the original license and copyright notice
📋 You disclose the source code when distributing
📋 Modified versions must also be licensed under GPL-3.0

See the LICENSE file for full details.

3.3 KiB Raw Blame History