Installation

Requirements

pip (all platforms)

python -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install boss-offline-ai

Docker

docker run --rm -it \
  -v "$HOME/.boss:/root/.boss" \
  ghcr.io/vectorlogic/boss-offline-ai:latest

The volume keeps the downloaded weights so you do not re-download them on every run.

Verifying the install

boss --version
boss doctor

boss doctor checks your Python version, available memory, and whether a usable accelerator is present. It never contacts the network.

Air-gapped setup

If the target machine has no internet access at all, download the model weights on a connected machine, copy them to ~/.boss/models/, and run boss doctor --offline to confirm everything resolves locally.

Troubleshooting

• boss: command not found — the virtual environment is not active.
• Out of memory — use --quantize int8 to halve the memory footprint.
• Slow first run — weights are being written to the local cache; later runs are fast.