Image Upscale Skill | Agent Skills

Image Upscale

Upscales an image using AI super-resolution models, increasing resolution while generating realistic detail.

Command

npx agent-media@latest image upscale --in <path> [options]

Inputs

| Option | Required | Description | |--------|----------|-------------| | --in | Yes | Input file path or URL | | --scale | No | Scale factor (2 or 4, default: 2) | | --out | No | Output path, filename or directory (default: ./) | | --provider | No | Provider to use (local, fal, replicate) | | --model | No | Model to use (overrides provider default) |

Output

Returns a JSON object with the upscaled image path:

{
  "ok": true,
  "media_type": "image",
  "action": "upscale",
  "provider": "local",
  "output_path": "upscaled_123_abc.png",
  "mime": "image/png",
  "bytes": 456789
}

Examples

Upscale an image (default 2x):

npx agent-media@latest image upscale --in photo.jpg

Upscale 4x with specific provider:

npx agent-media@latest image upscale --in photo.jpg --scale 4 --provider fal

Upscale with custom output:

npx agent-media@latest image upscale --in photo.jpg --out ./upscaled

Providers

local

Runs locally on CPU using Transformers.js, no API key required.

Uses Xenova/swin2SR-compressed-sr-x4-48 model (~1.3MB)
Always outputs 4x upscale regardless of --scale (model architecture limitation)
Models downloaded on first use
You may see a mutex lock failed error — ignore it, the output is correct if "ok": true

npx agent-media@latest image upscale --in photo.jpg --provider local

fal

Requires FAL_API_KEY
Uses fal-ai/esrgan (Real-ESRGAN) model
Supports 2x and 4x scale

replicate

Requires REPLICATE_API_TOKEN
Uses nightmareai/real-esrgan model
Supports 2-10x scale

Agent Skills: Image Upscale

Install this agent skill to your local

Skill Files