Install via npm

npx (recommended)

The simplest way to use vanya is with npx — no installation required:

npx @vanya-lang/vanya check my_test.vanya
npx @vanya-lang/vanya build my_test.vanya -o out/
npx @vanya-lang/vanya fmt my_test.vanya

This downloads and caches the binary automatically. Works everywhere without permission issues.

For project-local installs, add to your package.json:

npm install --save-dev @vanya-lang/vanya

Then run via npx vanya or add scripts to package.json:

{
  "scripts": {
    "test:check": "vanya check tests/*.vanya",
    "test:build": "vanya build tests/*.vanya -o out/"
  }
}

npm install -g @vanya-lang/vanya

The npm package bundles the native binary for your platform.

On Linux, global npm installs often fail with EACCES: permission denied. Use npx instead, or configure a user-local prefix:

npm config set prefix ~/.npm-global
export PATH=~/.npm-global/bin:$PATH  # add to ~/.bashrc

vanya --version

The current version is 0.3.4.

Create your first test.