Installation

This package can be installed in two ways: globally using pipx for easy command-line access, or locally using uv for development.

Global installation with pipx (recommended)

pipx is the recommended way to install Python CLI applications globally. It creates isolated environments for each package, avoiding dependency conflicts.

Install pipx

# On Ubuntu/Debian
sudo apt install pipx

# On macOS
brew install pipx

# Or using pip
pip install --user pipx
pipx ensurepath

Install virtuoso-utilities

pipx install virtuoso-utilities

Verify installation

# Launch Virtuoso with Docker
virtuoso-launch --help

# Bulk load data
virtuoso-bulk-load --help

# Dump quadstore
virtuoso-dump --help

# Rebuild full-text index
virtuoso-rebuild-index --help

Local development with uv

For development or if you prefer to use uv:

Clone the repository

git clone https://github.com/opencitations/virtuoso_utilities.git
cd virtuoso_utilities

Install dependencies

uv sync --group dev

Run scripts

uv run python virtuoso_utilities/launch_virtuoso.py --help

Python version support

Virtuoso Utilities supports Python 3.9, 3.10, 3.11, 3.12, and 3.13.