mcpField
F
fal-realtime

fal-realtime

github.com/fal-ai-communityCreative & media25885 installsUpdated 24w ago
Repository

About fal-realtime

fal-realtime is a skill for generating images through fal.ai real-time models, aimed at interactive previews and rapid prompt iteration. Its script supports LoRA inputs and configurable generation options.

Key features

  1. 01Sub-second image generation
  2. 02Prompt-driven image creation
  3. 03LoRA weights and scale options
  4. 04Configurable model, size, seed, and count

Use cases

  1. 01Preview images in interactive applications
  2. 02Iterate quickly on prompt wording
  3. 03Generate style-guided images with LoRA

MCP support

The README mentions a `search_models` MCP tool for discovering real-time image-generation models; generation itself is run through `realtime.sh`.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/fal-ai-community/skills --skill fal-realtime

After installing, type/fal-realtimein Claude Code to confirm it loaded.

Bundled filesscripts/realtime.sh

Details

From the project README

fal-realtime

Real-time and streaming image generation using fal.ai's fastest models. Results in under 1 second — ideal for interactive applications, live previews, and rapid iteration.

Scripts

ScriptPurpose
realtime.shGenerate images in real-time (sub-second)

Usage

Quick Real-Time Generation
./scripts/realtime.sh --prompt "A cute cat wearing a top hat"
With LoRA
./scripts/realtime.sh --prompt "A portrait in sks style" --lora-url "https://example.com/lora.safetensors"
Multiple Rapid Iterations
./scripts/realtime.sh --prompt "Abstract art with flowing colors, version 1"
./scripts/realtime.sh --prompt "Abstract art with flowing colors, version 2, more vibrant"
./scripts/realtime.sh --prompt "Abstract art with flowing colors, version 3, darker tones"

Arguments

ArgumentDescriptionRequired
--prompt / -pImage descriptionYes
--model / -mModel endpointNo (default: fal-ai/flux-2/klein/realtime)
--sizesquare, landscape, portraitNo (default: square)
--seedRandom seed for reproducibilityNo
--lora-urlURL to LoRA weightsNo
--lora-scaleLoRA influence (0.0-1.0, default: 1.0)No
--num-imagesNumber of images (default: 1)No

Finding Models

To discover the best and latest real-time generation models, use the search API:

# Search for real-time / fast image generation models
bash /mnt/skills/user/fal-generate/scripts/search-models.sh --query "realtime"
bash /mnt/skills/user/fal-generate/scripts/search-models.sh --query "fast image"
bash /mnt/skills/user/fal-generate/scripts/search-models.sh --category "text-to-image"

Or use the search_models MCP tool with keywords like "realtime", "fast", "schnell", "turbo".

When to Use Real-Time vs Standard Generation

Use CaseUse Real-TimeUse Standard
Rapid prototyping / iterationYes
Interactive apps / live previewYes
Final high-quality outputYes (FLUX Dev, Nano Banana Pro)
Professional / commercial workYes (FLUX Pro Ultra)
Exploring prompt ideas quicklyYes
Batch generation with variationsYes

Output Format

{
  "images": [
    {
      "url": "https://fal.media/files/...",
      "content_type": "image/jpeg",
      "width": 1024,
      "height": 1024
    }
  ],
  "seed": 12345,
  "has_nsfw_concepts": [false]
}

Tips

  • Real-time models use fewer inference steps — prompts should be clear and concise
  • Use --seed to lock in a good composition, then iterate on the prompt
  • LoRA support works with FLUX Klein Realtime — great for style-locked fast iteration
  • These models use the synchronous API (no queue), so results are instant

Comments

Markdown supported