morzai-cli

Official npm package for the Morzai command-line client.

Install

npm install -g morzai-cli

The executable command is morzai.

If your local npm is pointed at a private registry, publish and install checks should explicitly use the public npm registry:

npm whoami --registry https://registry.npmjs.org/

Authenticate

Recommended flow:

morzai auth device-login
morzai auth verify --json

Manual fallback:

morzai config set --access-key <your-access-key> --secret-key <your-secret-key>
morzai auth verify --json

Public Workflows

Apparel recolor:

morzai apparel-recolor \
  --input ./demo.jpg \
  --target-color "#B8B8B8" \
  --output ./result.jpg

Garment retouch:

morzai garment-retouch \
  --input ./demo.jpg \
  --correction-intensity high \
  --output ./result.jpg

Clothing adjustment:

morzai clothing-adjustment \
  --input ./demo.jpg \
  --preset-direction balanced_cleanup \
  --output ./result.jpg

Ecommerce product kit:

morzai ecommerce-product-kit \
  --input ./demo.jpg \
  --product-info "Portable blender with leak-proof lid" \
  --platform amazon \
  --market US \
  --output-type listing_set \
  --download-dir ./artifacts

Wait for an existing task:

morzai task wait <task-id> --download-dir ./artifacts --json

Command Reference

• morzai auth device-login [--timeout-ms <ms>] [--no-open] [--json]
• morzai auth verify [--json]
• morzai config set --access-key <ak> --secret-key <sk> [--json]
• morzai task wait <task-id> [--interval-ms <ms>] [--timeout-ms <ms>] [--download-dir <dir>] [--json]
• morzai apparel-recolor --input <file-or-url> (--target-color <value> | --target-color-image <file-or-url>) [--target-part <name>]... [--pattern-behavior <keep|recolor|remove>] [--output-mode <2k|4k>] [--output <file>] [--json]
• morzai garment-retouch --input <file-or-url> [--correction-intensity <low|medium|high>] [--output-resolution <2k|4k>] [--output <file>] [--json]
• morzai clothing-adjustment --input <file-or-url> --preset-direction <light_cleanup|balanced_cleanup|strong_flattening|surface_cleanup> [--output <file>] [--json]
• morzai ecommerce-product-kit --input <file-or-url> --product-info <text> [--image-ref <file-or-url>]... [--platform <amazon|taobao|tiktok_shop|shopify|temu|shein|instagram|pinterest>] [--market <code>] [--language <text>] [--aspect-ratio <ratio>] [--output-type <hero|detail|lifestyle|marketing_poster|listing_set>] [--style-name <text>] [--brand-tone <text>] [--brand-mood <text>] [--download-dir <dir>] [--output <file>] [--json]

Notes

• apparel-recolor requires one target color source.
• garment-retouch and clothing-adjustment can run with only --input plus the required preset direction for clothing adjustment.
• ecommerce-product-kit is used for full listing sets, hero images, detail images, lifestyle scenes, and marketing posters.
• ecommerce-product-kit requires --product-info and usually works best with --download-dir for multi-image output.
• --input accepts a local file path or an http/https image URL.
• --json returns machine-readable output for automation.
• Network requests honor local proxy environment variables: HTTPS_PROXY, HTTP_PROXY, ALL_PROXY, and NO_PROXY. Example: HTTPS_PROXY=http://127.0.0.1:7890 morzai auth verify.
• The published package targets npm public registry and requires Node.js 18 or newer.

Maintainer Release Checklist

Before publishing to npm public registry:

1. Configure npm auth for the public registry:

npm whoami --registry https://registry.npmjs.org/

2. Provide the embedded production CLI endpoint for release builds:

export MORZAI_CLI_DEFAULT_ENDPOINT="<production-cli-endpoint>"
export MORZAI_CLI_DEFAULT_WEB_ENDPOINT="https://www.morzai.ai"

3. Run a dry run:

npm run release:dry

4. Publish:

npm run release