Vectorizer.AI CLI

Official command-line client for the Vectorizer.AI image vectorization API.

The CLI is distributed as a single native executable named vectorizer for Windows, macOS, and Linux. It has no runtime dependency on Python, Node.js, Java, .NET, PHP, Ruby, or the generated SDK packages.

Authentication

Set your API credentials in the environment:

export VECTORIZER_API_ID="your-api-id"
export VECTORIZER_API_SECRET="your-api-secret"

On Windows PowerShell:

$env:VECTORIZER_API_ID = "your-api-id"
$env:VECTORIZER_API_SECRET = "your-api-secret"

You can also pass credentials before the command:

vectorizer --api-id your-api-id --api-secret your-api-secret account

Usage

Vectorize a local image:

vectorizer vectorize logo.png -o logo.svg

Generate another output format:

vectorizer vectorize logo.png -o logo.pdf --format pdf

Vectorize an image by URL:

vectorizer vectorize --url https://example.com/logo.png -o logo.svg

Retain an image token for later downloads:

vectorizer vectorize logo.png -o logo.svg --retention-days 7

If the API returns X-Image-Token or X-Receipt, the CLI prints those headers to stderr.

Download a retained result:

vectorizer download IMAGE_TOKEN -o logo.pdf --format pdf

Delete a retained image:

vectorizer delete IMAGE_TOKEN

Check account status:

vectorizer account

Pass advanced API form fields literally with --param key=value:

vectorizer vectorize logo.png -o logo.svg --param processing.max_colors=16

Release Artifacts

GitHub Releases produce:

• Windows x64 and arm64 zip archives
• macOS x64 and arm64 tarballs
• Linux x64 and arm64 tarballs
• Linux .deb, .rpm, and .apk packages
• SHA-256 checksums

Linux builds are made with CGO_ENABLED=0 so the binary is static and works across ordinary distributions without libc package coupling.

Development

go test ./...
go run ./cmd/vectorizer version

License

Apache-2.0