Skip to main content
vio deploys and operates Viorant agents from a terminal. It validates a .vio file, stands the agent up on Viorant Cloud and hands you a URL — the same deploy pipeline as the Hub, without opening it. vio ships as one self-contained JavaScript file. It needs Node 22:

​
macOS and Linux

The installer puts vio in ~/.viorant/bin/vio without sudo. If that folder isn’t on your PATH, it prints the line to add:
Open a new shell, then check:

​
Windows

There is no installer script for Windows yet. Download the file and check its checksum in PowerShell:
Run commands as node vio.js <command>.

​
Upgrade

Run the install command again. It replaces vio in place. To install a specific version:

​
How releases are verified

Every release is built and signed by Viorant’s GitHub release workflow, using keyless Sigstore signing recorded in the public Rekor transparency log.
  • The installer always checks the sha256 checksum before writing anything.
  • If cosign is installed, the installer also verifies the signature and refuses a bad one.
  • Without cosign, it prints signature NOT verified and the command to check by hand:
A checksum proves the file arrived intact. The signature proves it came from Viorant’s release workflow.

​
Next

Sign in

Connect vio to your Viorant account.

Deploy an agent

Validate a .vio file and put it on Viorant Cloud.