{"id":49109001,"url":"https://github.com/machinefi/qspro-cli","last_synced_at":"2026-05-27T03:01:13.193Z","repository":{"id":351919482,"uuid":"1212996862","full_name":"machinefi/qspro-cli","owner":"machinefi","description":"OpenAI-compatible API CLI for DeepSeek V3, DeepSeek R1, and Qwen 3.5. Agent-friendly — every command emits --json with stable exit codes.","archived":false,"fork":false,"pushed_at":"2026-04-17T03:07:02.000Z","size":17,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-23T05:02:49.160Z","etag":null,"topics":["ai-agents","cli","deepseek","inference","llm","openai","openrouter-alternative","python","quicksilverpro","qwen"],"latest_commit_sha":null,"homepage":"https://quicksilverpro.io","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/machinefi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-17T00:11:38.000Z","updated_at":"2026-04-17T03:07:05.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/machinefi/qspro-cli","commit_stats":null,"previous_names":["machinefi/qspro-cli"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/machinefi/qspro-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/machinefi%2Fqspro-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/machinefi%2Fqspro-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/machinefi%2Fqspro-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/machinefi%2Fqspro-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/machinefi","download_url":"https://codeload.github.com/machinefi/qspro-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/machinefi%2Fqspro-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33548246,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-27T02:00:06.184Z","response_time":53,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","cli","deepseek","inference","llm","openai","openrouter-alternative","python","quicksilverpro","qwen"],"created_at":"2026-04-21T03:30:41.266Z","updated_at":"2026-05-27T03:01:13.180Z","avatar_url":"https://github.com/machinefi.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# QuickSilver Pro CLI\n\n`qsp` — a command-line client for [QuickSilver Pro](https://quicksilverpro.io), one OpenAI-compatible API for top LLMs (DeepSeek, Qwen, Kimi, Gemini) **and** FLUX text-to-image — billed to a single balance. Open-source chat models run 20% below OpenRouter / Together / Fireworks.\n\nDesigned to be **AI-agent friendly**: data commands accept `--json` for structured output, exit codes are reliable, and the API surface is intentionally small.\n\n---\n\n## Related repos\n\nQuickSilver Pro is developed in three repositories under [`machinefi`](https://github.com/machinefi):\n\n| Component | Repo | Visibility |\n|-----------|------|------------|\n| **CLI** — `qsp` command-line client (this repo) | [`qspro-cli`](https://github.com/machinefi/qspro-cli) | Public |\n| Backend — API gateway + billing | [`qspro-backend`](https://github.com/machinefi/qspro-backend) | Private |\n| Frontend — landing + dashboard | [`qspro-frontend`](https://github.com/machinefi/qspro-frontend) | Private |\n\nEnd-user site: \u003chttps://quicksilverpro.io\u003e.\n\n---\n\n## Install\n\n```bash\npip install quicksilverpro\n```\n\nPython 3.9+. Also exports itself as `quicksilverpro` if you prefer the long name.\n\n---\n\n## Quick start\n\n```bash\nqsp init                          # opens dashboard to get a key, stores it locally\nqsp chat \"Write me a haiku\"       # one-shot streaming chat (deepseek-v4-flash by default)\nqsp image \"a fox in the snow\"     # text-to-image, saves a file (flux.2-pro by default)\nqsp balance                       # current credits\nqsp models                        # supported models with prices \u0026 context length\nqsp status                        # live per-model latency\n```\n\n---\n\n## Commands\n\n| Command | Purpose |\n|---|---|\n| `qsp init [--email X] [--key sk-...]` | Sign in (browser walkthrough) or paste an existing key |\n| `qsp logout` | Forget locally-stored key |\n| `qsp whoami [--json]` | Show signed-in email + balance |\n| `qsp balance [--json]` | Credit balance + lifetime spend |\n| `qsp models [--json]` | Available models + pricing + context length |\n| `qsp chat \"PROMPT\" [-m MODEL] [-s SYS] [--max-tokens N] [--temperature F] [--no-stream] [--json]` | One-shot completion, streams to stdout by default |\n| `qsp image \"PROMPT\" [-m MODEL] [-o FILE] [--size WxH] [-n N] [--json]` | Text-to-image; saves to a file (`flux.2-pro` by default) |\n| `qsp usage [-n 10] [--json]` | Recent calls + aggregate per-model |\n| `qsp status [--json]` | Live health of API + per-model probes |\n| `qsp keys list [--json]` | Your API keys |\n| `qsp keys create ALIAS [--monthly-limit USD] [--json]` | Create a new key with optional spend cap |\n| `qsp keys delete ALIAS [-y]` | Delete a key (confirmation prompt unless `-y`) |\n| `qsp pay {5,20,50}` | Opens Stripe checkout for a credit top-up |\n\n---\n\n## AI-agent usage\n\nData commands (`chat`, `image`, `models`, `balance`, `usage`, `status`, `keys list`/`create`, `whoami`) support `--json` and print OpenAI-shaped JSON to stdout with errors on stderr.\n\n```bash\nqsp models --json | jq '.[].id'\nqsp usage --json  | jq '.totals.cost'\nqsp chat \"Summarize: $DOCUMENT\" --json --no-stream | jq -r '.choices[0].message.content'\nqsp image \"a fox in the snow\" -o fox.png        # writes fox.png\nqsp image \"a fox in the snow\" --json | jq -r '.data[0].b64_json' | base64 -d \u003e fox.png\n```\n\nExit codes: `0` success · `1` remote/operational error · `2` usage / auth error.\n\n---\n\n## Config\n\nKey stored at `~/.config/quicksilverpro/config.json` (chmod 600). Override with:\n\n- `QSP_API_KEY` — use this key directly, ignore stored config\n- `QSP_API_URL` — default `https://api.quicksilverpro.io/v1`\n- `QSP_AUTH_URL` — default `https://pay.quicksilverpro.io`\n- `QSP_MODEL` — default model for `qsp chat`\n- `QSP_IMAGE_MODEL` — default model for `qsp image`\n- `QSP_CONFIG_DIR` — where to store config\n- `QSP_HTTP_TIMEOUT` — seconds, default 60 (image requests default to 180)\n\n---\n\n## Use the `openai` SDK directly\n\nYou don't need this CLI to use QuickSilver Pro. The OpenAI Python / Node / Swift SDKs work with only a `base_url` change:\n\n```python\nfrom openai import OpenAI\nclient = OpenAI(\n    base_url=\"https://api.quicksilverpro.io/v1\",\n    api_key=\"sk-...\",   # your QuickSilver Pro key\n)\nr = client.chat.completions.create(\n    model=\"deepseek-v3\",\n    messages=[{\"role\": \"user\", \"content\": \"Hello\"}],\n)\n```\n\nSee [quicksilverpro.io/dashboard#quickstart](https://quicksilverpro.io/dashboard#quickstart) for JS / Swift / curl.\n\n---\n\n## License\n\nMIT.\n\nQuickSilver Pro is a product of MachineFi Inc. (68 Willow Rd, Menlo Park, CA).\n\nLinks: [home](https://quicksilverpro.io) · [status](https://quicksilverpro.io/status) · [terms](https://quicksilverpro.io/terms) · [privacy](https://quicksilverpro.io/privacy)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmachinefi%2Fqspro-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmachinefi%2Fqspro-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmachinefi%2Fqspro-cli/lists"}