Why This Exists

You want to generate an image or video from the command line. You do not want to open a browser, manage SDKs, or write boilerplate API calls. You want one command that works with Flux, Kling, Veo, GPT Image, and more.

GenAI gives you that. Set an API key, run genai image "your prompt", and get a file on disk. Switch models with a flag. Pipe JSON output into scripts. Let your AI coding agent call it as a skill.

Install

Homebrew (macOS / Linux)

brew tap 199-biotechnologies/tap
brew install genai

Cargo (all platforms)

cargo install genai-media

From source

git clone https://github.com/199-biotechnologies/genai
cd genai && cargo install --path .

Set your API key

# fal.ai — 10+ image and video models
export FAL_KEY=your-key-here

# OpenAI — gpt-image-1
export OPENAI_API_KEY=your-key-here

Get a fal.ai key at fal.ai/dashboard/keys. Get an OpenAI key at platform.openai.com/api-keys.

How It Works

prompt ──> genai ──> provider API ──> file on disk
                  │
                  ├── auto-detects provider from your API key
                  ├── resolves model (or uses your --model flag)
                  └── saves .png or .mp4 with spinner + progress

1. You pass a text prompt and optional flags (model, size, duration, output path)
2. GenAI picks the provider based on which API key you have set (or your --provider flag)
3. It calls the API, downloads the result, and saves it to disk
4. In a pipe or with --json, it outputs structured JSON for scripting

Supported Models

Image Models

Model	Provider	Description
nano-banana-2 (default)	fal.ai	Nano Banana 2 (Google) -- best quality, text rendering
flux-2-pro	fal.ai	FLUX 2 Pro -- fast, high quality
flux-pro	fal.ai	FLUX Pro 1.1 -- general-purpose
flux-dev	fal.ai	FLUX Dev -- fast, good quality
flux-schnell	fal.ai	FLUX Schnell -- fastest, lower quality
gpt-image-1 (default)	OpenAI	GPT Image 1 -- high quality

Video Models

Model	Provider	Description
kling-video (default)	fal.ai	Kling 3.0 Pro -- cinematic motion, 1080p
veo3	fal.ai	Veo 3.1 (Google) -- highest quality, 4K
ltx-video	fal.ai	LTX Video 2.0 Pro -- fast, affordable ($0.02/video)
minimax-video	fal.ai	Minimax -- fast, good quality
sora (default)	OpenAI	Sora -- video generation (API pending)

Run genai models to see all available models. Filter with genai models --type image or genai models --type video.

Usage Examples

Generate images

# Use the default model
genai image "a majestic horse at sunset"

# Pick a specific model and size
genai image "minimalist logo" --model flux-dev --size 1024x1024

# Force a provider and save to a specific file
genai image "portrait photo" --provider openai --output portrait.png

Generate videos

# Default model, 5-second video
genai video "drone shot of a forest"

# Specific model, longer duration
genai video "waves crashing" --model minimax-video --duration 10

# Vertical video for social media
genai video "city timelapse" --aspect-ratio 9:16

Scripting and automation

# JSON output for pipelines
genai image "test" --json | jq '.file_path'

# List models as JSON
genai models --json

AI agent integration

GenAI works as a skill inside Claude Code, Gemini CLI, and other agent frameworks.

# Install the skill for your AI agent
genai skill install

# Machine-readable capability manifest
genai agent-info | jq

Output Modes

Context	Behavior
Terminal	Spinner with progress. Saves to ./<slug>-<timestamp>.png or .mp4
Piped / --json	Structured JSON with status, file path, provider, model, timing
--output	Override the output file path

Contributing

Contributions are welcome. See CONTRIBUTING.md for setup instructions and guidelines.

The fastest way to contribute: add a new model to src/models.rs and open a PR.

License

MIT -- see LICENSE for details.

---