vws-cli

Installation

With pip

Requires Python 3.14+.

$ pip install VWS-CLI

With Homebrew (macOS, Linux, WSL)

Requires Homebrew.

$ brew tap VWS-Python/vws
$ brew install vws-cli

With Nix

Requires Nix.

$ nix --extra-experimental-features 'nix-command flakes' run "github:VWS-Python/vws-cli" -- --help

To avoid passing --extra-experimental-features every time, enable flakes permanently.

Or add to your flake inputs:

{
  inputs.vws-cli.url = "github:VWS-Python/vws-cli";
}

With Docker

$ docker run --rm "ghcr.io/vws-python/vws-cli" --help

To use vuforia-cloud-reco:

$ docker run --rm --entrypoint vuforia-cloud-reco "ghcr.io/vws-python/vws-cli" --help

To use vumark:

$ docker run --rm --entrypoint vumark "ghcr.io/vws-python/vws-cli" --help

With winget (Windows)

Requires winget.

$ winget install --id VWSPython.vws-cli --source winget --exact
$ winget install --id VWSPython.vuforia-cloud-reco --source winget --exact

Pre-built Linux binaries

See the full documentation for details on how to install pre-built Linux binaries.

Pre-built Windows binaries

Download the Windows executables from the latest release and place them in a directory on your PATH. The filenames are:

vws-windows.exe
vuforia-cloud-reco-windows.exe
vumark-windows.exe

Pre-built macOS (ARM) binaries

See the full documentation for details on how to install pre-built macOS binaries.

Usage example

$ vws add-target \
    --server-access-key "$SERVER_ACCESS_KEY" \
    --server-secret-key "$SERVER_SECRET_KEY" \
    --name my_image_name \
    --width 2 \
    --image ~/Documents/my_image.png \
    --application-metadata "$(echo 'my_metadata' | base64)" \
    --active-flag true
03b99df0-78cf-4b01-b929-f1860d4f8ed1
$ vws --help
...
$ vuforia-cloud-reco my_image.jpg \
    --max-num-results 5 \
    --include-target-data none
- target_id: b60f60121d37418eb1de123c381b2af9
- target_id: e3a6e1a216ad4df3aaae1f6dd309c800
$

Full documentation

See the full documentation for information on:

All available commands.
Setting up autocompletion.
How to contribute to this project.
Release notes.

Development Status
- 5 - Production/Stable
Environment
- Web Environment
Operating System
- Microsoft :: Windows
- POSIX
Programming Language
- Python :: 3 :: Only
- Python :: 3.14

Metadata

Development Status
- 5 - Production/Stable
Environment
- Web Environment
Operating System
- Microsoft :: Windows
- POSIX
Programming Language
- Python :: 3 :: Only
- Python :: 3.14

Release files for vws-cli 2026.8.30.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for vws-cli 2026.8.30.4
File	Size	Uploaded
vws_cli-2026.8.30.4.tar.gz	154.4 kB	Aug 30, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for vws-cli 2026.8.30.4
File	Interpreter	ABI	Platform	Reset
vws_cli-2026.8.30.4-py3-none-any.whl 23.5 kB Aug 30, 2026	Python 3	none	any	Details

Total release size: 177.9 kB

Release files / vws_cli-2026.8.30.4.tar.gz

Download URL	vws_cli-2026.8.30.4.tar.gz
Size	154.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`8c7d6dffb8c61eda5de064bf3709ccb73cf79682df7286c61040d5b1bf00955d`
BLAKE2b-256 checksum How to use checksums	`baec98fbb039c93006c810016c1c5a5e12552c3c08b9ab849ba3f37894d34ea4`
Upload date	Aug 30, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/VWS-Python/vws-cli
Publishing commit: github.com/VWS-Python/vws-cli/tree/8637cf6fe736c25e65a33492e594b64b2961312b

Workflow

Publishing configuration: github.com/VWS-Python/vws-cli/blob/8637cf6fe736c25e65a33492e594b64b2961312b/.github/workflows/release.yml
Publishing logs: github.com/VWS-Python/vws-cli/actions/runs/33306190172/attempts/1

Artifact

Subject: vws_cli-2026.8.30.4.tar.gz
SHA-256 checksum: 8c7d6dffb8c61eda5de064bf3709ccb73cf79682df7286c61040d5b1bf00955d Verifying attestations

Release files / vws_cli-2026.8.30.4-py3-none-any.whl

Download URL	vws_cli-2026.8.30.4-py3-none-any.whl
Size	23.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`27571acc91eced1b1162345583729884442d67c382683fe5f0e2fdd985f8e598`
BLAKE2b-256 checksum How to use checksums	`0343840b114e9931e1f4ea0e3d8d8c9b378a964885d64c6d9965dac405012140`
Upload date	Aug 30, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/VWS-Python/vws-cli
Publishing commit: github.com/VWS-Python/vws-cli/tree/8637cf6fe736c25e65a33492e594b64b2961312b

Workflow

Publishing configuration: github.com/VWS-Python/vws-cli/blob/8637cf6fe736c25e65a33492e594b64b2961312b/.github/workflows/release.yml
Publishing logs: github.com/VWS-Python/vws-cli/actions/runs/33306190172/attempts/1

Artifact

Subject: vws_cli-2026.8.30.4-py3-none-any.whl
SHA-256 checksum: 27571acc91eced1b1162345583729884442d67c382683fe5f0e2fdd985f8e598 Verifying attestations