mcpField
T
transform-remove-background-with-transloadit

transform-remove-background-with-transloadit

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

About transform-remove-background-with-transloadit

transform-remove-background-with-transloadit is a skill for removing the background from a local image with Transloadit’s Node CLI. It provides guidance for preparing the steps file, resolving credentials, and saving a transparent PNG.

Key features

  1. 01Process a local input image
  2. 02Configure background removal in steps.json
  3. 03Resolve credentials from supported locations
  4. 04Save output as a transparent PNG
  5. 05Check assembly status when debugging

Use cases

  1. 01Remove a photo background for an asset
  2. 02Create a PNG with a transparent background

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/transloadit/skills --skill transform-remove-background-with-transloadit

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

Details

From the project README

Inputs

  • Absolute path to a local input image
  • Optional output path; default to an explicit sibling .png

Prepare Instructions

Resolve credentials in this order:

  • Shell environment variables
  • The current working directory .env only
  • ~/.transloadit/credentials

If your .env lives in a parent directory, export the variables into the shell first.

Create steps.json in the current working directory.

Important:

  • For the current CLI, the file passed to --steps must be a flat object keyed by step name.
  • Do not wrap the steps under a top-level "steps" key.
{
  ":original": {
    "robot": "/upload/handle"
  },
  "background_removed": {
    "use": ":original",
    "robot": "/image/bgremove",
    "format": "png",
    "result": true
  }
}

Run (Local Input Image)

npx -y @transloadit/node assemblies create \
  --steps ./steps.json \
  -i ./input/source.jpg \
  -o ./out/result.png

Replace ./input/source.jpg with your real input image path when needed.

After the command finishes, confirm the PNG exists at the expected output path.

Debug If It Fails

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

Notes:

  • Keep format: "png" so the downloaded output preserves transparency.
  • Prefer ~/.transloadit/credentials as the default fallback when you want a reusable user-level setup.
  • A current-directory .env still takes precedence, so avoid it when deterministic account selection matters.
  • If credentials only exist in a repo-root .env, run the command from that directory or export the variables first.
  • Prefer an explicit PNG filename like ./out/result.png. With the current CLI, using a directory output for a single result may preserve the input path instead of giving you a .png filename.
  • Prefer a clear foreground subject photo; background removal quality depends on the source image.

Comments

Markdown supported