Skip to content
Sign in
Getting Started

Installation

Votrio is a global CLI tool distributed via npm. Install it once and use it across every project on your machine.

Prerequisites

  • Node.js 18 or later
  • npm, pnpm, yarn, or bun
1

Install votrio globally

Choose your preferred package manager:

$npm install -g votrio
2

Verify the installation

Confirm votrio was installed correctly:

$votrio --version
→ votrio v0.1.0
3

Authenticate (optional for AI features)

AI-powered trace analysis requires an API key. Votrio uses Anthropic Claude under the hood.

$votrio auth

You can also set ANTHROPIC_API_KEY in your environment and Votrio will pick it up automatically.

4

Setup Python AI Service (optional)

For advanced AI code review with machine learning, install Python dependencies:

$cd backend && bash setup_python.sh

This installs scikit-learn and other ML libraries for real code analysis.

You're ready

Head to Quick Start to run your first analysis.

Troubleshooting

EACCES: permission denied (Linux / macOS)

If you get a permissions error, configure your npm prefix to a user-writable directory:

Fix npm permissions
mkdir ~/.npm-global npm config set prefix '~/.npm-global' export PATH=~/.npm-global/bin:$PATH

Add the export PATH line to your ~/.zshrc or ~/.bashrc.

command not found: votrio (after install)

Your shell may need to be reloaded after a global install:

$source ~/.zshrc # or source ~/.bashrc