Keep control and keys in your environment
CLI, full executor chain, orchestration, safety policy, and reports on your machine. Best for daily work and evaluating VOLY.
Install LocalYOUR FIRST MANAGED RUN
Get your first VOLY report
Check your repository without installing anything, then install the published package and begin with a dry-run. File changes are rolled back while the diff and run report remain available for review.
Time to first report≈ 3 minutes
Python3.10–3.14
SystemWindows · macOS · Linux
Zero-install checkuv · no API key
CHOOSE YOUR RUNTIME
Local now or Cloud for the team
Team surface in the browser
Orgs, members, shared history of local and hosted runs, spend — plus a hosted sandbox without installing the CLI.
Open CloudLOCAL · 4 STEPS
From PyPI to a verified result
Start with a zero-install check, then keep VOLY in an isolated environment for daily work. Clone the repository only if you plan to contribute to the core.
01
Check
Run the read-only preflight
uvx downloads VOLY into a temporary environment. The check inspects your repository and local executors without writing files or starting an agent.
uvx --from voly==0.1.0 voly quickstart --check --cwd .
You get a readiness report and a safe suggested next command.
02
Install
Install the published package
Install VOLY from PyPI in your preferred virtual environment. The universal wheel supports Windows, macOS, and Linux.
python -m pip install voly==0.1.0
voly --version
VOLY 0.1.0 is available in the current environment.
03
Configure
Add a key and create the config
Create the local configuration, then add at least one provider key to your environment. VOLY protects secret files from agent writes by default.
voly quickstart --yes --cwd .
voly status
Status shows at least one available executor or provider.
04
Verify safely
Run your first dry-run
Point VOLY at a test repository. The agent completes the task, but file writes are rolled back and the diff remains in the report.
voly run "review README and suggest one improvement" --cwd . --dry-run
The repository is unchanged; the result, touched files, and dry-run diff are saved.
AFTER THE RUN
Inspect evidence, not only the answer
Read the latest run in the CLI or start the local dashboard on port 7788.
voly runs list
voly runs show <task_id>
voly ui