@qbtz/cli

The Elite Quantum Computing Environment Orchestrator — Superposed. Orchestrated. Measured.

A fast, modern Node control plane over the real Python quantum stack. qbtz bootstraps an isolated per-project quantum environment, scaffolds runnable circuits, runs them, and checks the environment.

Install / use

npx @qbtz/cli init            # scaffold a .qbtz-env venv + main.py in the current directory
# or
npm i -g @qbtz/cli && qbtz --help

Requires Python 3 on your PATH (python3 -m venv). Nothing is installed globally — each project gets its own isolated .qbtz-env.

Commands

| Command | Description | | --- | --- | | qbtz init [dir] | Create .qbtz-env (venv), install qiskit, qiskit-aer, pennylane, jupyterlab, numpy, matplotlib, and scaffold a Bell-state main.py. | | qbtz add <name> [-C dir] | Scaffold a starter circuit: bell, ghz, grover, or teleport → <name>.py. | | qbtz run [file] [-C dir] | Run a circuit (default main.py) inside .qbtz-env — no manual activation needed. | | qbtz doctor [dir] | Report environment health: host python3, .qbtz-env, Qiskit/PennyLane versions, circuit files. |

Typical flow

qbtz init                 # build the environment + a Bell circuit
qbtz run                  # run main.py in the venv
qbtz add grover           # scaffold grover.py
qbtz run grover.py        # run it
qbtz doctor               # verify the stack

run and doctor invoke the environment's own interpreter directly (.qbtz-env/bin/python), so you never have to activate manually. Circuits are standard Qiskit programs using AerSimulator.

License

MIT © Dane Anthony Cooper