8000 GitHub - hink/genx: fal ai interface for generating images · GitHub
[go: up one dir, main page]

Skip to content
7FFF
hinkPublic

About

fal ai interface for generating images

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

GenX Studio

Next.js image generation studio powered by Fal.ai with local-first history.

Features

  • Parallel generation across supported models:
    • fal-ai/nano-banana-2
    • fal-ai/nano-banana-pro
    • fal-ai/gpt-image-1.5
    • xai/grok-imagine-image
    • fal-ai/bytedance/seedream/v5/lite
  • Automatic mode switching:
    • No references => text-to-image endpoint
    • References present => edit endpoint
  • Reference input via URL, upload, or paste
  • Optional Enhance prompt toggle:
    • Choose Grok 4.20 (default), Gemini 3.1, or GLM 5 for prompt enhancement
    • When enabled, prompt text is transformed into strict JSON using the selected OpenRouter model
    • Enhanced JSON is then sent to Fal.ai
    • If enhancement fails, generation falls back to the original prompt for that request
  • Reference previews with remove controls
  • Generating and generated galleries with model badges
  • Per-image actions: add-to-references, download, delete
  • Full-screen modal with click-to-zoom behavior
  • Local persistence only (localStorage metadata + IndexedDB image payloads)

Configuration

Create .env.local:

cp .env.example .env.local

Set your keys:

FAL_API_KEY=your_fal_api_key
OPENROUTER_API_KEY=your_openrouter_api_key

OPENROUTER_API_KEY is only required when using the Enhance prompt switch.

Development

npm install
npm run dev

Open http://localhost:3000.

Production Build

npm run build
npm run start

Docker

Build the image:

docker build -t genx:latest .

Run it:

docker run -d \
  --name genx \
  --restart unless-stopped \
  -p 3000:3000 \
  -e FAL_API_KEY=your_fal_api_key \
  -e OPENROUTER_API_KEY=your_openrouter_api_key \
  genx:latest

OPENROUTER_API_KEY is optional unless you use the Enhance prompt feature.

Docker Compose

Create .env from the example and set keys:

cp .env.example .env

Start:

docker compose up -d --build

Unraid Notes

  • If you use the Docker Compose Manager plugin on Unraid, place this repo on your array/cache (for example /mnt/user/appdata/genx) and run docker compose up -d --build from that path.
  • If you use the Docker tab template UI, configure:
    • Repository/Image: genx:latest (if you built locally on the Unraid host) or your pushed registry tag
    • Host Port: your preferred port (for example 3000)
    • Container Port: 3000
    • Env vars: FAL_API_KEY and optional OPENROUTER_API_KEY

About

fal ai interface for generating images

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

0