CoreViz is a Vision AI platform for teams and individuals working with thousands of visual assets.

@coreviz/cli

An AI-powered CLI for working with photos. Semantically search, edit, tag and generate metadata for thousands of photos right from the command line.

Installation

npm install -g @coreviz/cli

Usage

# Run directly with npx
npx @coreviz/cli [command]

# Or if installed globally
coreviz [command]

Commands

AI Features

Describe an image:

npx @coreviz/cli describe path/to/image.jpg

Edit an image with a text prompt (🍌 Nano Banan + Flux Kontext in the CLI!):

npx @coreviz/cli edit path/to/image.jpg --prompt "make it cyberpunk style"

Generate tags or classify an image:

npx @coreviz/cli tag path/to/image.jpg "objects in the image"

Classify an image using specific choices:

npx @coreviz/cli tag path/to/image.jpg --choices "receipt,invoice,document" --single

Run tagging locally (offline capable):

npx @coreviz/cli tag path/to/image.jpg "prompt" --mode local

Search local images using natural language:

npx @coreviz/cli search "a person wearing a red t-shirt"

This will index the images in your current directory (creating a .index.db file) and return the top matches for your query.

You can also use the cloud API for embeddings:

npx @coreviz/cli search "query" --mode api

Scripting

All commands support a --quiet flag to suppress UI output and return only raw results.

# Returns only the file path of the edited image
npx @coreviz/cli edit image.jpg "prompt" --quiet

Authentication

Login to CoreViz using device authorization:

npx @coreviz/cli login

Logout:

npx @coreviz/cli logout

Check login status:

npx @coreviz/cli whoami

Development

1. Install dependencies:

   cd cli
   npm install

2. Run local CLI:

   node bin/cli.js --help