vibe-queue vibe-queue Schedule

Keep work moving across machines.

Queue, dispatch, and track command-line workloads on local machines, remote hosts, and configured scheduler backends.

made for your workflow

For researchers managing long calculations and teams sharing workstations or compute hosts.

The repository and product are vibe-queue. The shell command, Python distribution, and import package remain vq. Installing the queue does not build or install vibe-qc.

Schedule commands

Run vibe-qc jobs or other command-line workloads with the same queue.

Follow the work

Inspect queued and running jobs, their workspaces, and retrieved results.

Choose your deployment

Start with a local queue and add remote hosts or the optional web dashboard as needed.

get started

Install vibe-queue.

Python 3.12 or newer and Git. SSH access and any external scheduler setup are needed only for the hosts you use.

Clone the separate vibe-queue repository using GitLab, then run these commands from that checkout. The default installer makes a dedicated .venv with the CLI and daemon. Configure hosts and services using the queue guide after installation.

./scripts/install.sh
.venv/bin/vq --help

The GitHub mirror provides public source snapshots; GitLab requires authorized access. Public snapshots can lag GitLab, so check the desired ref on your chosen host. Source and access details.

works together, installs separately

Build the workflow you need.

QVF connects calculation and visualization through a published file format. The QVF specification and reference implementations live in their own Apache-2.0 project; vibe-qc implements the format independently.

Explore the QVF format ↗