Package Exports

@openpets/imagegen
@openpets/imagegen/index.ts

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@openpets/imagegen) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

ImageGen

Unified image and video generation across multiple providers. Aggregates tools from FAL, OpenAI, and Google Gemini into a single plugin with task-oriented presets.

Providers

Provider	Image Gen	Image Edit	Video Gen	Image Animate
FAL	Flux, Stable Diffusion	Style transfer, editing	Kling, Runway Gen-3	Image-to-video
OpenAI	DALL-E, GPT Image	GPT Image edit	-	-
Google Gemini	Prompt enhancement	Placeholder (Imagen 3)	Placeholder	-

Setup

Set at least one provider's API key:

# FAL AI (recommended for image + video)
FAL_KEY=your-fal-key

# OpenAI (DALL-E / GPT Image)
OPENAI_API_KEY=your-openai-key

# Google Gemini
GOOGLE_API_KEY=your-google-key

# Optional: bypass provider-level read-only filtering for imported tools
IMAGEGEN_BYPASS_READONLY=true

When IMAGEGEN_BYPASS_READONLY=true, ImageGen loads provider tools without applying the provider pet's own read-only filter (for example OpenAI image/video write tools). ImageGen still respects its own read-only setting for ImageGen-native composite tools.

Dimension Presets

The imagegen-create tool auto-selects dimensions per provider:

Preset	Description	Aspect
`logo`	Square logo/icon	1:1
`poster`	Vertical poster	3:4
`banner`	Wide horizontal banner	16:9
`social`	Social media post	1:1
`story`	Vertical story/reel	9:16
`thumbnail`	YouTube/video thumbnail	16:9
`cover`	Album/book cover	1:1
`wallpaper`	Desktop wallpaper	16:9
`portrait`	Portrait photo	3:4
`landscape`	Landscape photo	4:3

Usage

# List available providers and tools
opencode run "list all available image generation providers"

# Generate with preset dimensions
opencode run "create a logo for a coffee shop called Bean There"
opencode run "create a poster for a summer music festival"
opencode run "create a banner for my tech blog"

# Generate video
opencode run "generate a video of ocean waves at sunset"

# Use specific provider
opencode run "generate a portrait using openai"

Tools

ImageGen Tools (composite)

imagegen-list-providers - List all configured providers and their tools
imagegen-create - Generate image with preset dimensions, auto-routes to best provider
imagegen-create-video - Generate video, auto-routes to best provider

FAL Tools (when FAL_KEY is set)

fal-generate-image - Text-to-image (Flux, Stable Diffusion)
fal-transform-image - Image-to-image (style transfer, editing)
fal-generate-video - Text-to-video (Kling, Runway Gen-3)
fal-animate-image - Image-to-video animation

OpenAI Tools (when OPENAI_API_KEY is set)

openai-create-image - DALL-E / GPT Image generation
openai-create-image-edit - Image editing
openai-create-image-variation - Image variations (DALL-E 2)

Google Gemini Tools (when GOOGLE_API_KEY is set)

gemini-text-to-image - Prompt enhancement for image generation
gemini-image-to-image - Placeholder for future Imagen 3
gemini-text-to-video - Placeholder for future video generation