Skip to content

Install

Pick one method below. All paths install vow (native compiler) and vpm (package manager). No Python required.

Platform Command
macOS / Linux (curl) curl -fsSL https://install.vowlang.dev | sh then export PATH="$HOME/.local/bin:$PATH"
Homebrew brew tap vowlang/tap && brew trust vowlang/tap && brew install vow
macOS (.dmg) Vow-darwin-arm64.dmg — optional offline install (see Gatekeeper note)
Windows irm https://install.vowlang.dev/install.ps1 | iex — or VowSetup.exe when published

Supported CPU/OS: darwin-arm64, darwin-amd64, linux-amd64, linux-arm64.


Step 1 — Install and PATH

Terminal window
curl -fsSL https://install.vowlang.dev | sh
export PATH="$HOME/.local/bin:$PATH"

Step 2 — Verify

Terminal window
vow version # vow 0.1.0 (native)
vpm version

Default layout: ~/.local/bin/vow, ~/.local/bin/vpm, runtime under ~/.local/share/vow/.

Upgrades: re-run the same curl command. The installer replaces files cleanly — no manual chmod needed.

Custom prefix:

Terminal window
PREFIX=/usr/local curl -fsSL https://install.vowlang.dev | sh

Step 1 — Tap and trust (trust is required once on Homebrew 4.x)

Terminal window
brew tap vowlang/tap https://github.com/vowlang/homebrew-vowlang
brew trust vowlang/tap

Step 2 — Install

Terminal window
brew install vow
vow version

If you see a checksum error after a new release, run brew update and try again.


Use this only if you want an offline bundle. curl or Homebrew above is easier — unsigned downloads are often blocked by Gatekeeper even with Right-click → Open.

Step 1 — Download

Step 2 — Clear quarantine and install

Terminal window
xattr -d com.apple.quarantine ~/Downloads/Vow-darwin-arm64.dmg
open ~/Downloads/Vow-darwin-arm64.dmg
xattr -cr "/Volumes/Vow 0.1.0"
open "/Volumes/Vow 0.1.0/Install Vow.command"

Step 3 — PATH

Terminal window
export PATH="$HOME/.local/bin:$PATH"
vow version
vpm version

Native Windows vow.exe is on the roadmap. Today, use the PowerShell installer (WSL2 or Git Bash).

Step 1 — Install (recommended)

Terminal window
irm https://install.vowlang.dev/install.ps1 | iex

Step 2 — Inside WSL/Ubuntu

Terminal window
export PATH="$HOME/.local/bin:$PATH"
vow version

When published: download VowSetup.exe, double-click, and follow the wizard. If the link 404s, use the PowerShell command above.

  1. If prompted, install WSL2 (wsl --install in Admin PowerShell), restart, and run again
  2. Inside WSL: export PATH="$HOME/.local/bin:$PATH" then vow version

After install, add the global process manager for vow-web-server:

Terminal window
vpm add vow-serve -g
export PATH="$HOME/.vow/global/bin:$PATH" # vow-serve, vs, vds

See Deploying vow-web-server.


This is the same flow as Your first program:

Terminal window
vow new my-app
cd my-app
vow check src/main.vow # prints: ok: src/main.vow
vow run src/main.vow # prints: Hello from Vow!
echo $? # 0
vow build src/main.vow -o my-app
./my-app
echo $? # 0

The scaffolded entry file is always src/main.vow (see main = "src/main.vow" in project.toml).

Full command list: CLI commands.


Terminal window
git clone https://github.com/vowlang/vow.git
git clone https://github.com/vowlang/vow-package-manager.git # sibling
cd vow
./installers/install-native.sh
export PATH="$HOME/.local/bin:$PATH"
vow check tests/lang/simple.vow
vpm --version

Custom prefix: PREFIX=/usr/local ./installers/install-native.sh.

  • macOS: Xcode Command Line Tools (xcode-select --install)
  • Linux: clang, lld, make, curl, tar (for building from source)
  • End-user curl install: only curl + tar