On this page
Quickstart
Get BOSS Offline AI running locally in a few minutes — no account, no API key, no network.
What you need
- A machine with at least 8 GB of RAM
- Python 3.10 or newer, or Docker
- No API key. BOSS runs offline; nothing phones home.
1. Install
pip install boss-offline-ai
Or, with Docker:
docker run --rm -it ghcr.io/vectorlogic/boss-offline-ai:latest
2. Ask a question
boss ask "explain a closure in plain words"
The first run downloads the model weights to a local cache. After that, the model works with the network switched off.
3. Use it from Python
from boss import Boss
model = Boss.load("v1.3")
print(model.ask("summarise this paragraph in one sentence"))
Choosing a version
| Version | Best for | Caveat |
|---|---|---|
| v1.1 | General knowledge questions | Older instruction-following |
| v1.3 | Instruction following, structured output | Weaker general knowledge than v1.1 |
The v1.3 general-knowledge regression is real and documented on the Benchmarks page. Read it before deciding.
Where to go next
- Installation — per-OS and Docker detail
- Projects — every artefact we publish
- Contributing — how to send a patch