BCCLI system requirements

Runtime

Node.js 22 or newer. This is a hard floor: an older Node installs the package cleanly and then fails at startup, so check it first when a fresh install will not run:

node --version

Terminal

A normal interactive terminal — PowerShell or Windows Terminal on Windows, a Linux shell, or an SSH session such as Termius. BCCLI draws an interactive interface, so a terminal that cannot handle that will make the session unusable even when everything else is configured.

Network

Cloud providers need internet access. Local providers do not: they need their own runtime running on the machine, and the model files already downloaded.

Confirming the install

bccli --version
bccli models

The first line proves the binary runs. The second proves BCCLI can reach at least one provider — if it prints an empty list, the install is fine and the provider configuration is not.

Next

• Install and first run — the full first-run path.
• Diagnostics — when one of these checks fails.