Image Upscaler v1.0.0

Images image-upscaler 2 actions MCP

Batch-upscale images 2x/3x/4x with Real-ESRGAN (ncnn/Vulkan, runs on the AMD card, no torch), writing enlarged copies to an 'upscaled' subfolder while leaving originals untouched. Folder runs fan out into several parallel processes sized to free VRAM.

Open in Omniscient Back to apps

The omniscient:// link needs a protocol handler on your machine, which is not built yet. Until then it does nothing — use the commands below.

Actions

Jump to: upscale_imageupscale_folder

Upscale one image

upscale_image

Upscale a single image file with Real-ESRGAN and save a copy.

Inputs

Name	Type	Required / default	Values and notes
`image`	path	required
`model`	enum	optional, default `realesrgan-x4plus`	`realesrgan-x4plusrealesrgan-x4plus-animerealesrnet-x4plus`
`scale`	int	optional, default `4`
`format`	enum	optional, default `jpg`	`jpgpngwebp`
`out_dir`	path	optional, default `""`

Outputs

Name	Type	Notes
`file`	path
`out_dir`	path

Upscale a folder

upscale_folder

Upscale every image in a folder with Real-ESRGAN, writing copies to an 'upscaled' subfolder. Originals are never modified. Runs several realesrgan processes in parallel (default: auto-sized to free VRAM) so large batches use the whole GPU.

Inputs

Name	Type	Required / default	Values and notes
`folder`	path	required
`model`	enum	optional, default `realesrgan-x4plus`	`realesrgan-x4plusrealesrgan-x4plus-animerealesrnet-x4plus`
`scale`	int	optional, default `4`
`format`	enum	optional, default `jpg`	`jpgpngwebp`
`recursive`	bool	optional, default `false`
`skip_prefix`	string	optional, default `""`
`out_dir`	path	optional, default `""`
`workers`	int	optional, default `0`

Outputs

Name	Type	Notes
`count`	int
`out_dir`	path
`workers`	int

Use it

Upscale one image

Command line

shell

python app.py --action upscale_image --params '{"image": "D:/path/to/image"}'

Run from the app’s own folder. Single quotes work in bash and PowerShell; in cmd.exe use double quotes and escape the inner ones.

MCP tool

mcp

run_action("image-upscaler", "upscale_image", {"image": "D:/path/to/image"})

Workflow node

json

{
  "id": "n0",
  "app": "image-upscaler",
  "action": "upscale_image",
  "params": {
    "image": "D:/path/to/image"
  },
  "inputs": {}
}

Upscale a folder

Command line

shell

python app.py --action upscale_folder --params '{"folder": "D:/path/to/folder"}'

Run from the app’s own folder. Single quotes work in bash and PowerShell; in cmd.exe use double quotes and escape the inner ones.

MCP tool

mcp

run_action("image-upscaler", "upscale_folder", {"folder": "D:/path/to/folder"})

Workflow node

json

{
  "id": "n0",
  "app": "image-upscaler",
  "action": "upscale_folder",
  "params": {
    "folder": "D:/path/to/folder"
  },
  "inputs": {}
}

Example prompts

Things you can say to Claude, Cursor or Codex once the MCP server is registered.

upscale every image in D:/photos 4x with Real-ESRGAN
4x-upscale this poster folder for print, skip files starting with bg_
upscale this one image with the anime model
upscale this 1000-image folder using 4 parallel workers