Installation
Install via npm, run zero-install via npx, and check system requirements.
Imagerry CLI is available both as standalone native binaries (zero runtime or Node.js dependencies required) and as a standard npm package with precompiled native Skia graphics engine bindings (@napi-rs/canvas).
Option 1: Standalone Binary (Zero Node.js Required)
Recommended for Docker containers, CI/CD runners, lightweight servers, or users without Node.js installed.
macOS & Linux
curl -fsSL https://imagerry.com/cli/install.sh | bashWindows (PowerShell)
irm https://imagerry.com/cli/install.ps1 | iexThe installer automatically detects your operating system and CPU architecture, downloads the precompiled binary alongside the native Skia graphics library, and places imagerry into your system PATH.
Option 2: Global Installation via npm (Node.js)
If you already have Node.js (18+) installed on your system:
npm install -g @imagerry/cliVerify your installation:
imagerry -v
# Output: v0.2.1-betaAlternative Package Managers
# pnpm
pnpm add -g @imagerry/cli
# yarn
yarn global add @imagerry/cliOption 3: Zero-Install Execution (npx)
If you do not want to install the CLI globally or are running in an ephemeral CI runner:
npx @imagerry/cli -i screenshot.png -o styled.png --preset meshSupported Architectures & Operating Systems
| Operating System | Architecture | Standalone Binary | npm / npx Package |
|---|---|---|---|
| macOS (12+) | Apple Silicon (arm64) | ✅ | ✅ |
| macOS (12+) | Intel (x64) | ✅ | ✅ |
| Linux (Ubuntu, Debian, Fedora, Arch) | x64 (glibc 2.27+) | ✅ | ✅ |
| Linux (Ubuntu, Debian, Fedora, Arch) | arm64 (aarch64) | ✅ | ✅ |
| Windows (10 / 11) | x64 | ✅ | ✅ |
| Windows (10 / 11) | arm64 | ✅ | ✅ |
| Android (Termux) | arm64 | ✅ | ✅ |
Updating the CLI
Standalone Binary
Rerun the installer script to automatically fetch and verify the latest binary in-place:
curl -fsSL https://imagerry.com/cli/install.sh | bashnpm Package
npm update -g @imagerry/cli