Set up

Installation

Choose the package manager that fits your workflow. Homebrew and uv install Valcore as an isolated command-line tool.

Homebrew install

Recommended on macOS. The tap provides the valcore command and keeps upgrades simple.

brew install duncankmckinnon/tap/valcore
valcore --help

uv tool install

Use uv to install Valcore in an isolated environment without adding it to a project's dependencies.

uv tool install valcore
valcore --help

To send Valcore's own traces to Logfire, install the optional integration:

uv tool install 'valcore[logfire]'

pip install

Install with pip when you manage Python tools in a dedicated virtual environment.

python -m venv .venv
source .venv/bin/activate
pip install valcore
valcore --help

Launch the workbench

valcore serve

This starts Valcore locally and opens the visual workbench. Your workspace is stored locally and shared with the CLI.