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

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
File	Size	Uploaded
vws_cli-2026.8.30.tar.gz	154.4 kB	Aug 30, 2026	Details

Built distribution (wheel)

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

Total release size: 177.8 kB

Release files / vws_cli-2026.8.30.tar.gz

Download URL	vws_cli-2026.8.30.tar.gz
Size	154.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`80893febcb6aecf6f91517a48ae80c4d4358e970ae75e6c5997d21985ade7e0c`
BLAKE2b-256 checksum How to use checksums	`3e2c0b8772e892acb1594441788e81c1a2fddde2abe83f1c7b004a15088fc278`
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/aea7e32f654752f665a60f40278e041ea1cb3347

Workflow

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

Artifact

Subject: vws_cli-2026.8.30.tar.gz
SHA-256 checksum: 80893febcb6aecf6f91517a48ae80c4d4358e970ae75e6c5997d21985ade7e0c Verifying attestations

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

Download URL	vws_cli-2026.8.30-py3-none-any.whl
Size	23.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`4b348041b621ac1b9a5aea7c593ff38f080e2061e7842e44448bb034de2703de`
BLAKE2b-256 checksum How to use checksums	`d86b6cf4482473abf70d4092f94b936ea0aeaf87ba61e965ef062d595560cdf5`
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/aea7e32f654752f665a60f40278e041ea1cb3347

Workflow

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

Artifact

Subject: vws_cli-2026.8.30-py3-none-any.whl
SHA-256 checksum: 4b348041b621ac1b9a5aea7c593ff38f080e2061e7842e44448bb034de2703de Verifying attestations