Installation¶

Basic Installation¶

pip install v2hub-cli

This installs the v2hub command and pulls in the v2hub client library automatically. Requires Python 3.10+.

With Admin Support¶

Admin commands (v2hub admin ...) require the optional v2hub-admin package:

pip install v2hub-cli[admin]

If v2hub-admin is not installed, the admin command group is hidden from v2hub --help, but v2hub admin version still works and reports the situation — see Graceful Admin Fallback.

Development Install¶

git clone https://github.com/nestthub/v2hub-cli.git
cd v2hub-cli
pip install -e ".[admin,dev]"

dev pulls in pytest, mypy, ruff, and v2hub-admin so the full test suite (including admin commands) runs locally.

Verifying the Install¶

v2hub version

ⓘ Versions
v2hub: 1.1.2
v2hub-cli: 1.1.4
v2hub-admin: not installed

v2hub-admin shows not installed unless you installed the [admin] extra.

Requirements¶

Next Steps¶

Once installed, set up configuration and authentication so v2hub knows which API to talk to.