Install and sign in

bitsrun is one free program that does two jobs:

• A command line for your BitsRun account. Deploy models, check which GPU a model needs, manage API keys and uploads, and see what you spent. Every command is listed in Command reference.
• A coding agent in your terminal. Type bitsrun with nothing after it and it opens an agent that reads and edits your code and runs commands after you approve them, with any model provider. See bitsrun coding agent.

Install

Pick the line for your computer. The install script chooses the right build and checks its SHA-256 checksum before installing.

macOS and Linux

curl -fsSL https://get.bitsrun.com | sh

It installs to ~/.local/bin. If that folder is not on your PATH yet (common on a new Mac), the script prints the line that adds it to your shell's startup file. Run that line, then open a new terminal. On Alpine Linux, run apk add libstdc++ libgcc first.

Windows

Open PowerShell and run:

irm https://get.bitsrun.com/win | iex

It installs to %LOCALAPPDATA%\bitsrun\bin and adds that folder to your PATH. Open a new terminal window afterwards so the PATH change applies. Windows on Arm is not covered by this script yet: install with npm instead.

With npm

If you already use Node.js 22 or later. This also works on Windows on Arm and on Linux machines that are not x64 or arm64:

npm install -g bitsrun

The install page shows the same three options, each with a Copy button.

Check that it works:

bitsrun --version

Sign in

bitsrun login

1. Your browser opens on bitsrun.com. Sign in with your email code or passkey if you are not already signed in.
2. Click Allow. The page names the computer asking for access, so you know which one you are approving.
3. Back in the terminal, bitsrun confirms it:

Signed in as MacBook Pro. This session lasts until 2027-02-07.
Next: bitsrun deploy qwen3:8b

The session lasts 90 days and is saved in a file only you can read: ~/.config/bitsrun/credentials.json on macOS and Linux, %APPDATA%\bitsrun\credentials.json on Windows.

Signing in over SSH or without a browser

On a remote server, or with --no-browser, bitsrun prints a link instead of opening a browser:

bitsrun login --no-browser

Open the link on any device where you can sign in, click Allow, then paste the code the page shows into the terminal.

See and remove signed-in computers

Every computer that ran bitsrun login is listed in the dashboard under API keys, in the Signed-in CLIs section, with when it was last used. Click Sign out next to any you do not recognize. To sign out the computer you are on:

bitsrun logout

Signing in again on the same computer replaces its old session, so you never collect stale ones. More in Sessions and devices.

Your first deploy from the terminal

bitsrun deploy qwen3:8b --name "Support chat" --key

This creates a private endpoint, picks the smallest GPU that fits, and creates an API key that only works with this endpoint. The key is printed once, so save it in your password manager or secret store right away. The output ends with a curl command you can paste to try it. Call your endpoint explains the next steps.

Keep bitsrun up to date

bitsrun upgrade

It downloads the latest version, checks it against a signed list of checksums, and swaps the file in place. If you installed with npm, update with npm install -g bitsrun@latest instead.

What can go wrong

Errors from your account show a Request id for support. Include it when you write to support@bitsrun.com.