wwewtech/numes-deepseek-harness ↗★ 2

numes-deepseek-harness

Zero-dependency local proxy wiring Numes's $0 :free model pool into DSH as an OpenAI-compatible provider, with never-give-up retries, Retry-After-aware backoff, and auto-discovery.

Package
numes-deepseek-harness
Compatibility
Unverified
Harness peer range
>=0.2.0
Version
1.3.0
License
MIT
Last updated
Nov 21, 2026

Install

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:wwewtech/numes-deepseek-harness

usage.cost: 0


## ⚠️ Honest limits

- **`$0` ≠ unlimited.** Free offers appear and vanish with provider prices; auto-discovery keeps the list current but cannot conjure capacity. If every free offer is gone, rounds keep failing *honestly*.
- **`$0` ≠ instant.** The free pool measured 50–85s to first token (short pings: ~3–8s). Set a generous `max_tokens` (1500+) — reasoning tokens eat the budget, and `max_tokens: 40` yields an empty answer with `finish_reason: "length"`.
- **`$0` ≠ private.** Providers declare their own data policies; read them before sending secrets. The proxy itself never logs your key or prompts.
- **Not a Numes or DeepSeek product.** Independent glue, verified on DSH Desktop 0.2.2-rc.3 with a USD key on 17 Nov 2026. DSH rc.4/rc.5 only change server-side search and bug fixes, not the provider setup this repo documents.

## 🖼️ Visual tour

  
    Terminal
    DSH model picker (real screenshot)
    Retry flow
  
  
    

![Proxy terminal output: startup, /status JSON, cost guard](https://raw.githubusercontent.com/wwewtech/numes-deepseek-harness/cca2fb2241d548d36e9b35a11e9726e490274dd0/docs/assets/terminal.png)

    

![DSH model picker showing Numes free (auto-failover) selected](https://raw.githubusercontent.com/wwewtech/numes-deepseek-harness/cca2fb2241d548d36e9b35a11e9726e490274dd0/docs/assets/dsh-model-picker.png)

    

![Request lifecycle: guard → max_price → Numes → stream or retry](https://raw.githubusercontent.com/wwewtech/numes-deepseek-harness/cca2fb2241d548d36e9b35a11e9726e490274dd0/docs/assets/flow.png)

  

🛡️ `dsh-model-picker.png` and `dsh-model-list.png` are **real screenshots** from DSH Desktop 0.2.2-rc.3 showing the bundle-installed provider. `terminal.png` and `flow.png` are illustrative mockups. SVG originals in [`docs/assets/`](https://github.com/wwewtech/numes-deepseek-harness/blob/cca2fb2241d548d36e9b35a11e9726e490274dd0/docs/assets/).

---

## 📚 Everything else

| | |
|---|---|
| 🇷🇺 **Полный гайд (рекомендуется)** | [docs/SETUP.ru.md](https://github.com/wwewtech/numes-deepseek-harness/blob/cca2fb2241d548d36e9b35a11e9726e490274dd0/docs/SETUP.ru.md) — от установки DSH до первого ответа, с разбором ошибок |
| 🇬🇧 Full setup guide | [docs/SETUP.md](https://github.com/wwewtech/numes-deepseek-harness/blob/cca2fb2241d548d36e9b35a11e9726e490274dd0/docs/SETUP.md) — the same, in English |
| 🇨🇳 **中文全指南** | [docs/SETUP.zh.md](https://github.com/wwewtech/numes-deepseek-harness/blob/cca2fb2241d548d36e9b35a11e9726e490274dd0/docs/SETUP.zh.md) — 完整安装、排错与 API 用法 |
| 🇨🇳 **中国人(README)** | [README.zh.md](https://github.com/wwewtech/numes-deepseek-harness/blob/cca2fb2241d548d36e9b35a11e9726e490274dd0/README.zh.md) — 项目总览 |
| 🔧 Proxy reference | [tools/README.md](https://github.com/wwewtech/numes-deepseek-harness/blob/cca2fb2241d548d36e9b35a11e9726e490274dd0/tools/README.md) — every env var, header, and behaviour |
| ⚙️ DSH config blocks | [configs/](https://github.com/wwewtech/numes-deepseek-harness/blob/cca2fb2241d548d36e9b35a11e9726e490274dd0/configs/) — direct and proxy routes |
| 📦 DSH bundle | [`.dsh-plugin/manifest.json`](https://github.com/wwewtech/numes-deepseek-harness/blob/cca2fb2241d548d36e9b35a11e9726e490274dd0/.dsh-plugin/manifest.json) + root `package.json` — `dsh plugin add github:wwewtech/numes-deepseek-harness` |
| 📋 Changelog | [CHANGELOG.md](https://github.com/wwewtech/numes-deepseek-harness/blob/cca2fb2241d548d36e9b35a11e9726e490274dd0/CHANGELOG.md) — what changed in each version |
| 🛡️ Security & contributing | [SECURITY.md](https://github.com/wwewtech/numes-deepseek-harness/blob/cca2fb2241d548d36e9b35a11e9726e490274dd0/SECURITY.md) · [CONTRIBUTING.md](https://github.com/wwewtech/numes-deepseek-harness/blob/cca2fb2241d548d36e9b35a11e9726e490274dd0/CONTRIBUTING.md) |
| 🧪 **Examples** | [`examples/`](https://github.com/wwewtech/numes-deepseek-harness/blob/cca2fb2241d548d36e9b35a11e9726e490274dd0/examples/) — curl, Python, PowerShell, Node, tool-calls |
| 📸 **Real screenshots** | [`dsh-model-picker.png`](https://raw.githubusercontent.com/wwewtech/numes-deepseek-harness/cca2fb2241d548d36e9b35a11e9726e490274dd0/docs/assets/dsh-model-picker.png) · [`dsh-model-list.png`](https://raw.githubusercontent.com/wwewtech/numes-deepseek-harness/cca2fb2241d548d36e9b35a11e9726e490274dd0/docs/assets/dsh-model-list.png) |

## ✅ What CI checks

Every push runs [`.github/workflows/ci.yml`](https://github.com/wwewtech/numes-deepseek-harness/blob/cca2fb2241d548d36e9b35a11e9726e490274dd0/.github/workflows/ci.yml), which verifies the claims made above rather than trusting them:

- the proxy parses, boots, and answers `/health` with a non-empty chain;
- the **paid-model guard really returns `400`** for a non-free id, before any network I/O;
- every relative Markdown link resolves;
- no Numes key (or GitHub token) is committed;
- each config lists only `:free` Numes ids;
- the source still contains the guard, `max_price`, backoff, `Retry-After`, discovery, and fatal-abort code the README advertises;
- the **root `package.json`** declares `dsh.bundle.patch`, `.dsh-plugin/manifest.json` references a real `cordis.patch.yml`, and the listed entry file exists;
- **7 integration tests** (`tests/proxy.test.mjs`) covering the guard, `/health`, `/status`, `/v1/models`, chain override, unknown routes and bad JSON.

Run the same checks locally:

```bash
node tools/check-repo.mjs
npm test

📄 License

MIT. Not affiliated with DeepSeek or Numes. Applies Numes ToS and AUP; no account automation, no quota evasion.