mcpField
T
transform-upscale-image-with-transloadit

transform-upscale-image-with-transloadit

github.com/transloaditCreative & media560 installsUpdated 1w ago
Repository

About transform-upscale-image-with-transloadit

transform-upscale-image-with-transloadit is a skill for AI upscaling local images with the Transloadit CLI. It lets users choose a model and scale, enable face enhancement, and specify an output path for photos, illustrations, or portraits.

Key features

  1. 01Upscale local images from the CLI
  2. 02Choose an upscaling model
  3. 03Set 2x or 4x scaling
  4. 04Enable face enhancement
  5. 05Specify the output file path

Use cases

  1. 01Upscale local photos or illustrations
  2. 02Improve facial detail during upscaling
  3. 03Restore low-quality or damaged faces

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/transloadit/skills --skill transform-upscale-image-with-transloadit

After installing, type/transform-upscale-image-with-transloaditin Claude Code to confirm it loaded.

Details

From the project README

Run

Use the image upscale intent for quick AI upscaling of a local image.

npx -y @transloadit/node image upscale \
  --input ./photo.jpg \
  --output ./photo-upscaled.png

Defaults: --model nightmareai/real-esrgan, --scale 2, --face-enhance false.

Run With 4x Upscale

npx -y @transloadit/node image upscale \
  --input ./photo.jpg \
  --scale 4 \
  --output ./photo-upscaled.png

Run With Face Enhancement

Use when the input contains human faces that should be sharpened. Pair with gfpgan or codeformer for dedicated face restoration, or keep real-esrgan + --face-enhance for a general upscale that also improves faces.

--face-enhance is a boolean flag — pass it bare, not with true.

npx -y @transloadit/node image upscale \
  --input ./portrait.jpg \
  --face-enhance \
  --output ./portrait-upscaled.png

Pick A Model

  • nightmareai/real-esrgan (default): general-purpose SOTA upscaler for photos and illustrations.
  • tencentarc/gfpgan: specialized face restoration; best for portraits with damaged or low-quality faces.
  • sczhou/codeformer: alternative face restoration with more control over fidelity vs. quality.
npx -y @transloadit/node image upscale \
  --input ./portrait.jpg \
  --model tencentarc/gfpgan \
  --output ./portrait-restored.png

Notes:

  • Upscaling is an AI operation; processing time and cost scale with image size and --scale.
  • Without --output, the CLI writes next to the input file using the intent's default extension.
  • --scale only accepts 2 or 4.

Debug If It Fails

npx -y @transloadit/node assemblies get <assemblyIdOrUrl> -j

Notes:

  • Upscaling robots can be account-gated; if the assembly fails with capability or availability errors, confirm /image/upscale is enabled for your account or switch --model.
  • Very large inputs combined with --scale 4 can exceed per-account limits; try --scale 2 first.

Comments

Markdown supported