Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.tryvoss.dev/llms.txt

Use this file to discover all available pages before exploring further.

The recommended install path is the npm CLI package. It vendors Python 3.12 and the Voss wheel, so you do not need to manage a Python environment just to run the harness.

​
Prerequisites

  • Node.js 18 or newer for the npm package
  • Python 3.11 or newer if you install with pip or from source
  • Git
  • A terminal environment where Voss can run inside a repository
npm i -g @vosslang/cli

​
Alternative: pip

If you already manage Python 3.11+ yourself: 
pip install voss
Semantic memory/search dependencies are optional because they pull heavier vector-search packages: 
pip install "voss[search]"

​
Source checkout

Use an editable checkout for Voss development: 
git clone https://github.com/bm9797/Voss.git
cd voss
pip install -e ".[dev]"

​
Verify the CLI

voss --help
voss doctor
voss doctor checks local harness prerequisites such as config directories, provider setup, compiler availability, and tool readiness.
Use npm i -g @vosslang/cli for normal CLI use. Use pip install -e ".[dev]" when you are changing Voss itself.

​
Next steps