VOOL

Your machine. Your models. An agent that gets things done.

VOOL is a local-first personal agent from Parad0x Labs. It connects conversation to action: read a project, edit files, run tests, research the web, and carry useful context into the next session.

Start with a local model and no VOOL account or cloud API key. Connect your own cloud provider when you want more model choice. Your workspace, memory, and action history stay under your control.

Get started · Documentation · Explore the code · Community

Why VOOL

A conversation that can do the work

VOOL can read, plan, call tools, inspect results, and continue. Give it a repository to investigate, a file to produce, or a research question to work through. The runtime connects the model to tools for code, files, commands, documents, and the web.

Memory beyond one chat

Keep useful facts and decisions across sessions. Local memory, context management, and retrieval help the agent pick up where you left off. You can inspect and manage what it remembers. How memory works →

Your choice of models

Run local inference through Ollama or supported local runtimes, or connect a cloud model with your own credentials. Installation profiles adapt the local setup to your hardware. Cloud use is optional; provider charges apply when you enable it. Local and cloud →

Results you can inspect

Tool activity records what was requested, what executed, and what came back. Signed honesty receipts add tamper-evident records you can verify offline. You can inspect the work behind an answer—not just read its summary. Receipts →

Useful access, with boundaries

Workspace scopes and operating modes control what the agent can do. Choose how everyday actions are approved; sensitive operations retain their permission checks. Extend the runtime with plugins and MCP connections, with explicit control over the environment passed to external tools. Tools and permissions →

Install

Current version: 0.6.0-beta. Start from source with the commands below — this repository publishes no installer release (only a private owner-review draft). A macOS DMG is separately downloadable from the project website; that channel is not built from these release records, so verify its sidecar checksum and see the release status page for the authoritative state of artifacts, signing and updates.

macOS / Linux

Download the bootstrap script, then run it:

curl -fsSLo bootstrap_vool.sh https://raw.githubusercontent.com/Parad0x-Labs/vool/main/installer/bootstrap_vool.sh
bash bootstrap_vool.sh

Windows PowerShell

Invoke-WebRequest https://raw.githubusercontent.com/Parad0x-Labs/vool/main/installer/bootstrap_vool.ps1 -OutFile bootstrap_vool.ps1
powershell -ExecutionPolicy Bypass -File .\bootstrap_vool.ps1

The installer prepares the Python environment, checks your hardware, sets up the local model, and launches the local services. Allow time and disk space for the initial model download. Local model inference works offline after setup; web tools and cloud models need a connection. Legacy integration cleanup is tracked in the repository scope map.

Platform	Getting started
macOS / Apple Silicon	Primary desktop development target; source installer and macOS CI coverage.
Linux	Source installer; full Linux test shards run in CI.
Windows	Experimental desktop path; PowerShell installer and Windows gauntlet coverage. Use WSL2/Linux for jobs requiring a Linux kernel sandbox.

For model choices, system requirements, checksums, and troubleshooting, see the install guide and Windows capability matrix.

Choose a local profile or run from a checkout

The default profile is selected from your hardware. To choose explicitly:

bash bootstrap_vool.sh --install-profile local-only
# Or use the larger local model profile:
bash bootstrap_vool.sh --install-profile local-max

Windows accepts -InstallProfile local-only or -InstallProfile local-max. Use --no-start with the shell bootstrap to install without launching.

From an existing checkout, run bash Install_And_Run_VOOL.sh on macOS/Linux or double-click Install_And_Run_VOOL.bat on Windows.

To change the profile later, run this from your installation directory with its Python environment active, then restart VOOL:

python -m apps.vool_cli install-profile --set local-max

For a manual Windows API launch, activate the installed virtual environment and run:

py -m apps.vool_api_server

Quote any path with spaces. Manual setup and launch options are in the install guide.

Give it something real to do

Once your model and workspace are configured, try:

• Code: “Find why this test fails, fix the cause, and run the affected tests.”
• Research: “Compare these options using current sources and save the findings.”
• Documents: “Read these PDFs and summarize the differences with references.”
• Memory: “Remember this project decision so we can pick it up next session.”

These are starting prompts, not fixed demos. Available tools depend on your setup and permissions; task quality depends on the model you choose. Web research requires web access to be enabled.

Inspect the local service at /healthz, its activity at /trace, and configured features at /api/runtime/capabilities.

Check the receipts

From your installed environment, run the offline receipt demonstration:

python -m core.honesty_receipt demo

It creates and verifies sample receipts, then demonstrates tamper detection. To inspect the most recent real session ledger:

python -m core.honesty_receipt verify-last

A signature verifies the signed record's integrity; it is not a guarantee that every model answer is correct.

Explore further

Meet the related ecosystem projects, including Dark Null Protocol for privacy-preserving settlement.

VOOL also includes optional wallet/payment integrations and bounded local helper orchestration. Peer mesh, DHT and Brain Hive are retained experimental research, outside normal production networking. See the repository scope map for current runtime, integration, research and compatibility boundaries. Wallet and spending features require their own setup and authorization.

Explore	Start here
First session and model setup	First run · Connect a model
Workspace, memory, and control	Workspaces · Memory · Spending limits
Development and contribution	Repository map · Contributing
Reviewing VOOL	Reviewer guide · Evidence registry
Build status and troubleshooting	CI · Engineering status · Error reference · Troubleshooting
Security and licensing	Security policy · MIT license · Third-party notices

Built by Parad0x Labs. Contributor: sls_0x.