CLI Installation¶

The Vargate CLI (vargate-cli) lets you manage your governance proxy from the terminal.

Prerequisites¶

• Python 3.10 or higher
• pip

Install¶

pip install vargate-cli

Or install from source:

git clone https://github.com/zeroco84/vargate.ai.git
cd vargate.ai/cli
pip install -e .

Setup¶

Run the init command to configure your API URL and key:

vargate init

You'll be prompted for:

1. API URL — defaults to https://vargate.ai/api
2. API Key — your tenant API key from signup or dashboard

Configuration is saved to ~/.vargate/config.json:

{
  "api_url": "https://vargate.ai/api",
  "api_key": "vg-abc123..."
}

Verify Setup¶

Check that everything is connected:

vargate status

You should see gateway health, Redis status, blockchain connection, and Merkle tree count.

Then send a test action:

vargate test

This submits a test tool call and verifies it appears in the audit trail.

Next Steps¶

See Commands for the full command reference.