Google Vision CLI
A command-line interface for the Google Vision API. Wraps the google_vision Dart package to provide image detection and annotation from the terminal.
Table of Contents
- Quick Start
- Installation
- Prerequisites
- Authentication
- Usage
- Global Options
- Commands
- Feature Types
- License
Quick Start
# Install via Homebrew
brew tap cdavis-code/google-vision
brew install vision
# Run landmark detection
vision detect --image-file photo.jpg --features LANDMARK_DETECTION
Installation
Homebrew
brew tap cdavis-code/google-vision
brew install vision
# Run landmark detection
vision detect --image-file photo.jpg --features LANDMARK_DETECTION
Dart pub
# Activate globally
dart pub global activate google_vision_cli
# Or run directly from the workspace
vision <command> [arguments]
Prerequisites
- A Google Cloud service account with the Vision API enabled
- A JSON credentials file for the service account
Authentication
The CLI authenticates via JWT only using a service account key file (API keys are not supported).
# Place credentials at the default path
~/.vision/credentials.json
# Or specify a custom path
dart run vision --credential-file /path/to/credentials.json <command>
Usage
dart run vision [global-options] <command> [command-options]
Global Options
| Option | Default | Description |
|---|---|---|
--credential-file |
~/.vision/credentials.json |
Path to JWT credentials JSON file |
--log-level |
off |
Log level: all, debug, info, warning, error, off |
Commands
version
Display the package name and version.
dart run vision version
detect
Run image detection and annotation for a batch of images or files.
| Option | Required | Description |
|---|---|---|
--image-file |
yes | Path to the image file to process |
--features |
yes | Comma-separated list of detection types |
--pages |
no | Comma-separated list of page numbers for PDF/TIFF/GIF (max 5) |
--max-results |
no | Maximum results per feature (default: 10, max: 50) |
# Label detection on an image
dart run vision detect --image-file photo.jpg --features LABEL_DETECTION
# Multiple features on a single image
dart run vision detect --image-file photo.jpg \
--features LABEL_DETECTION,FACE_DETECTION,TEXT_DETECTION
# Process specific pages of a PDF
dart run vision detect --image-file document.pdf \
--features DOCUMENT_TEXT_DETECTION --pages 1,2,3
crop_hints
Get crop suggestion vertices for an image.
| Option | Required | Description |
|---|---|---|
--image-file |
yes | Path to the image file to process |
--aspect-ratios |
no | Comma-separated list of aspect ratios as floats (e.g. 1.33333 for 4:3) |
--pages |
no | Comma-separated list of page numbers for PDF/TIFF/GIF (max 5) |
# Get default crop hints
dart run vision crop_hints --image-file photo.jpg
# Specify desired aspect ratios
dart run vision crop_hints --image-file photo.jpg \
--aspect-ratios 1.33333,1.77778
safe_search
Detect explicit content (adult, violence, medical, racy) in an image.
| Option | Required | Description |
|---|---|---|
--image-file |
yes | Path to the image file to process |
dart run vision safe_search --image-file photo.jpg
highlight
Draw bounding boxes around detected objects and save the result.
| Option | Required | Description |
|---|---|---|
--image-file |
yes | Path to the image file to process |
--output-file |
yes | Path to save the annotated image |
--features |
no | Comma-separated list of detection types |
--line-color |
no | Box color: red, green, blue, white, black (default: red) |
--max-results |
no | Maximum results per feature (default: 10, max: 50) |
# Highlight detected faces
dart run vision highlight --image-file photo.jpg \
--output-file annotated.jpg --features FACE_DETECTION
# Highlight objects and landmarks in blue
dart run vision highlight --image-file photo.jpg \
--output-file annotated.jpg \
--features OBJECT_LOCALIZATION,LANDMARK_DETECTION \
--line-color blue
score
Get confidence scores for detected objects as a JSON array.
| Option | Required | Description |
|---|---|---|
--image-file |
yes | Path to the image file to process |
--features |
no | Comma-separated list of detection types |
--max-results |
no | Maximum results per feature (default: 10, max: 50) |
# Get face detection confidence scores
dart run vision score --image-file photo.jpg \
--features FACE_DETECTION
# Get label detection scores
dart run vision score --image-file photo.jpg \
--features LABEL_DETECTION
# Output: [0.98, 0.95, 0.87, ...]
Feature Types
| Feature | Description |
|---|---|
FACE_DETECTION |
Detect faces with facial attributes |
LANDMARK_DETECTION |
Detect popular landmarks |
LOGO_DETECTION |
Detect product logos |
LABEL_DETECTION |
Label image content (objects, activities, etc.) |
TEXT_DETECTION |
OCR — detect and extract text |
DOCUMENT_TEXT_DETECTION |
Dense text/document OCR with page/block/paragraph structure |
SAFE_SEARCH_DETECTION |
Adult/violent/explicit content likelihood |
IMAGE_PROPERTIES |
Dominant colors and image attributes |
CROP_HINTS |
Suggested crop region vertices |
WEB_DETECTION |
Web references and similar images |
PRODUCT_SEARCH |
Product search against a product set |
OBJECT_LOCALIZATION |
Detect and locate multiple objects |
See the Google Vision API documentation for details.
License
This project is licensed under the terms included in the repository.
Libraries
- google_vision_cli
- meta
- app metadata