VarityKit CLI Overview Guide

Varity Team Core Contributors Updated June 2026

VarityKit is a Python-based CLI that helps you deploy and manage applications. It is a familiar deploy CLI: install it, log in, and ship.

What You Can Do

Deploy Applications

Deploy supported Node, Python, Go, static, and Docker workloads with one command.

Migrate from Vercel

Move an existing Vercel app to Varity in one step: analyze, transform, and deploy.

Manage Deployments

List deployments, view status and logs, and redeploy a known-good version when needed.

Validate Setup

Run diagnostics to ensure your development environment is ready.

Commands at a Glance

Core Commands

Command	Description
`varitykit login`	Log in with your deploy key from the developer portal
`varitykit doctor`	Validate your development environment
`varitykit completions`	Set up shell completions (bash, zsh, fish)
`varitykit bootstrap`	Install a cloned project’s npm and pip dependencies (`--skip-npm`, `--skip-pip`, `--skip-docker`)

Authentication

Command	Description
`varitykit auth login`	Log in with your deploy key
`varitykit auth logout`	Remove saved credentials
`varitykit auth status`	Show current login status

App Deployment

Command	Description
`varitykit app deploy`	Deploy your application
`varitykit app list`	List all deployments
`varitykit app info`	Show deployment details
`varitykit app delete --yes`	Delete a deployment
`varitykit app status [RUN_ID]`	Show one deployment operation or your most recent deployment
`varitykit app templates`	List certified templates (`--json` for the raw catalog)
`varitykit app env NAME KEY=VALUE...`	Set environment variables on a live app, then redeploy in place (`--replace` overwrites the set)
`varitykit app redeploy NAME`	Reapply the saved configuration on the same URL
`varitykit app restart NAME`	Restart with a verified replacement on the same URL
`varitykit app rollback DEPLOYMENT_ID`	Redeploy an earlier configuration (`--confirm` skips the prompt)

Domains

Command	Description
`varitykit domains list`	List all domains you own on `varity.app`

Migration (Vercel → Varity)

Command	Description
`varitykit migrate --url <github-url>`	Clone a GitHub repo and migrate it to Varity (analyze + transform + deploy)
`varitykit migrate --path <path>`	Migrate a local Vercel project directory
`varitykit migrate --dry-run`	Preview what would change without modifying files
`varitykit migrate --no-deploy`	Apply codemods only, skip deployment
`varitykit migrate analyze <path>`	Scan for Vercel artifacts (read-only preview)
`varitykit migrate apply <path>`	Apply codemods without deploying
`varitykit migrate rollback <path>`	Restore files from `.vercel-migration-backup/`

Quick Start

# Install the CLI
pipx install varitykit

# Check your environment
varitykit doctor

# Log in with your developer portal deploy key
varitykit login

# Deploy from the GitHub repo of the current checkout (auto-detects static vs dynamic)
varitykit app deploy

# Or name the source explicitly
varitykit app deploy --repo-url https://github.com/you/my-app
varitykit app deploy --image ghcr.io/you/app:latest --port 8080
varitykit app deploy --template agent-zero --name my-agent

# Or force a specific mode
varitykit app deploy --hosting dynamic
varitykit app deploy --hosting static

Global Options

All commands support these global options:

varitykit [OPTIONS] COMMAND [ARGS]...

Options:
  --version        Show the CLI version
  -v, --verbose    Enable verbose output
  --debug          Enable debug output
  --json           Output in JSON format
  --help           Show help message

Requirements

Python: 3.11 or higher
Node.js: 20+ (for building JavaScript projects)

Hosting Options

Static Sites

Deploy static websites and single-page applications from their GitHub repository:

varitykit app deploy --repo-url https://github.com/you/my-site

Best for: Marketing sites, documentation, SPAs
Cost: First 3 static sites free, then $1/month per site, for verified accounts; 1 GB of pinned assets. See Pricing and Costs.
Speed: Global CDN distribution

Dynamic Apps

Deploy full-stack applications with backend:

varitykit app deploy --hosting dynamic

Best for: APIs, databases, server-side rendering, AI agents, LLMs
Cost: Up to a fixed monthly maximum per app, prorated by running time, based on the resources you reserve. See Pricing and Costs.
Features: Containers, scaling, persistence

Varity auto-detects when your app needs dynamic hosting (Express, Fastify, Next.js SSR, FastAPI, Django, Flask, etc.) and selects it automatically. Use --hosting dynamic only to force the mode explicitly.

Supported Frameworks

Varity currently auto-detects and deploys the following frameworks:

Framework	Static	Dynamic
Next.js 13+	Supported	Supported
React (Vite)	Supported	Supported
React (CRA)	Supported	Supported
Vue 3+	Supported	Supported
Express, Fastify, Nest, Koa, Hono	Not applicable	Supported
FastAPI, Django, Flask	Not applicable	Supported
Go modules	Not applicable	Supported
Plain static HTML	Supported	Not applicable
Runnable Docker/OCI HTTP images	Not applicable	Supported

Not yet source-built: Rust, Ruby / Rails, Elixir / Phoenix, Java / Spring, Deno, PHP / Laravel, .NET. These return a clean unsupported-stack error as source projects. Deploy them today with a runnable Docker/OCI image, or request source-build support.

Additional Command Details

completions

Set up shell completions for the CLI:

varitykit completions [OPTIONS]

Option	Description
`--shell`	Shell type: `bash`, `zsh`, or `fish` (auto-detected if omitted)
`--install`	Install completions to your shell config file

Next Steps

Install the CLI: Installation guide
Log in: Connect your developer account
Run diagnostics: Check your setup
Deploy your application: Deploy to production