Command-line tool

QuickSilver Pro CLI

qsp is a small, agent-friendly command-line client for QuickSilver Pro. Chat with top models and generate images from your terminal — data commands support --json and exit codes are stable, so it drops straight into scripts and agents.

Install

shell
# macOS / Linux — easiest
brew install machinefi/qspro/qspro

# or Python (any OS)
pipx install quicksilverpro
# (plain "pip install quicksilverpro" works too)

Both install a qsp command (and a longer quicksilverpro alias) on your $PATH. Python 3.9+. Use pipx if your Python is externally managed (PEP 668).

Sign in

shell
qsp init                 # opens the dashboard, paste your key back
# or, non-interactively:
qsp init --key sk-...

Your key is stored at ~/.config/quicksilverpro/config.json (chmod 600). The QSP_API_KEY environment variable overrides it — handy in CI.

Chat

shell
qsp chat "Write a haiku about debugging."     # streams to stdout
qsp chat "Summarize: $(cat file.md)" -m deepseek-v4-pro
qsp chat "Return JSON only" --json            # full OpenAI-shaped response

Defaults to deepseek-v4-flash; pick any model with -m, or set a default with QSP_MODEL. Add --json for the raw response (implies non-streaming).

Generate images

shell
qsp image "a sleek silver sports car, studio product shot"   # saves qsp-image-<ts>.jpg
qsp image "a yellow rubber duck" -m flux.1-schnell -o duck.jpg
qsp image "abstract album cover" -n 4 -o cover.jpg           # cover-1.jpg … cover-4.jpg

Text-to-image via the same key and balance as chat. Defaults to flux.2-pro ($0.027/image); use flux.1-schnell ($0.0025/image) for fast, high-volume work. Set a default with QSP_IMAGE_MODEL. See image generation for the API.

Account & keys

shell
qsp balance               # credits remaining
qsp models                # available models + pricing (chat and image)
qsp status                # live per-model latency
qsp usage -n 5            # last 5 calls with cost
qsp keys create prod-bot --monthly-limit 10
qsp keys list
qsp keys delete prod-bot
qsp pay 5                 # opens Stripe checkout for a $5 top-up

Built for scripts & agents

Commands that return data (chat, image, models, balance, usage, status, keys list/create, whoami) accept --json and print OpenAI-shaped JSON to stdout, with human messages and errors on stderr. Exit codes are stable: 0 success, 1 remote / operational error, 2 usage / auth error — so failures are easy to detect in CI and agent loops.

shell
qsp models --json | jq '.[].id'
qsp chat "Summarize: $DOCUMENT" --json --no-stream | jq -r '.choices[0].message.content'
qsp image "a fox in the snow" --json | jq -r '.data[0].b64_json' | base64 -d > fox.jpg

Source and full reference on GitHub · PyPI.