Submit

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 and import package remain vq; the Python distribution is vibe-queue. 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 public vibe-queue repository and run its installer 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.

git clone https://github.com/vibe-qc/vibe-queue.git
cd vibe-queue
./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 supported documents and results through a published file format. A sketch document and a calculated wavefunction carry different data; inspect the file contents and the consumer’s supported features. The QVF specification and reference implementations live in their own Apache-2.0 project; vibe-qc implements the format independently.

Explore the QVF format ↗