The SmartStick Agent is a small native companion that runs on your computer. It handles the privileged work a browser cannot: enumerating removable drives, unmounting, formatting, installing the runtime and model, and applying security settings. The SmartStick AI web app talks to it over an authenticated localhost connection.
Preview build v0.2.0. Open-source Python reference agent. Requires Python 3.9+. When it's running the web app auto-detects it (badge flips to LIVE AGENT) and uses it for real system info, real removable-drive enumeration, and real GGUF model downloads from Hugging Face with live progress. It refuses to format, partition, or eject — those require the signed native agent.
Capabilities.
GET /health · GET /system · GET /drives · POST /download-model · GET /download-progress · POST /cancel-download. Listens on http://127.0.0.1:43621.Windows
v0.2.0-preview · 4.8 KB
DownloadSmartStickAgent-0.2.0-preview-win-x64.zip
SHA-256 4477c9ee50d36ecd
macOS
v0.2.0-preview · 4.7 KB
DownloadSmartStickAgent-0.2.0-preview-mac-universal.zip
SHA-256 f1d32d2471babc9d
Linux
v0.2.0-preview · 4.1 KB
DownloadSmartStickAgent-0.2.0-preview-linux-x64.tar.gz
SHA-256 97a86b504d8939b3
The Agent connects to
https://127.0.0.1:43621 and uses a short-lived pairing token from the web app. It never executes arbitrary shell commands — only a strict allowlist of SmartStick operations.