Plugin directory / Developer / dsh-fingerprint-relay
dsh-fingerprint-relay
Unverified Wilfred-wei
What it does
DSH plugin: managed local fingerprint relays so DSH can reach providers that gate on the client's TLS fingerprint
Unverified — not yet verified
DSH plugin: managed local fingerprint relays so DSH can reach providers that gate on the client's TLS fingerprint Not yet verified — install and test it yourself.
“Unverified” means our automated CI has not yet installed this plugin. Feature descriptions and version compatibility are the author’s claims. This is not a security audit and not an endorsement of third-party code.
README
DSH Fingerprint Relay
Lets DSH reach providers that gate on the client's TLS fingerprint (for example agentrouter.org).
The plugin runs a local Python egress process that the upstream allow-lists, and forwards DSH's requests through it.
When you need it
The provider works in a browser or its official CLI, but DSH gets unauthorized client detected or a 403.
Requirements
- DSH Desktop (framework
0.1.0-rc.8) - Python 3.11+
Install
git clone https://github.com/Wilfred-wei/dsh-fingerprint-relay.git
cd dsh-fingerprint-relay
.\scripts\install.ps1
The script installs the plugin, creates a Python venv, installs its dependencies, writes the interpreter path into your profile, and verifies the result.
Then restart DSH Desktop.
Without the script: two manual steps
# 1. install the plugin
dsh plugin --profile web add dsh-fingerprint-relay
# 2. create the Python environment
$relay = "$env:USERPROFILE\.dsh\profiles\node_modules\dsh-fingerprint-relay"
python -m venv "$env:USERPROFILE\.dsh\fingerprint-relay-venv"
& "$env:USERPROFILE\.dsh\fingerprint-relay-venv\Scripts\python.exe" -m pip install -r "$relay\resources\requirements.txt"
Then point the plugin at that interpreter in %USERPROFILE%\.dsh\profiles\web\cordis.patch.yml:
- id: fingerprint-relay-host
config:
pythonPath: C:\Users\<you>\.dsh\fingerprint-relay-venv\Scripts\python.exe
Usage
- Settings -> Fingerprint relay -> Add relay
- Upstream URL:
https://agentrouter.org - Local port:
7187
- Upstream URL:
- Press Start; the status becomes
running / healthy - Under Providers through a relay, point an Anthropic provider (such as
agent-claude) at it - Chat as usual
The API key stays where it already is — in the provider's own configuration. The relay stores no keys.
Limitations
- Anthropic Messages channel only; on new-api style gateways set the provider's protocol to
anthropic-messageseven for GPT models (the gateway converts them). Native OpenAI endpoints are not supported. - The egress process listens on
127.0.0.1only - Accepted on Windows
Troubleshooting
| Symptom | Fix |
|---|---|
| No "Fingerprint relay" section in Settings | Restart DSH Desktop; dsh --profile web --dump-config should list fingerprint-relay-host |
| Start fails: missing Python packages | Re-run .\scripts\install.ps1, or pip install fastapi uvicorn httpx anthropic for that interpreter |
| Start fails: port in use | Pick another local port |
| Requests return 401 | That provider has no API key configured |
Long stall, then no stream data for 120s |
The upstream stalled; the relay already retried once — send again |
| Config change had no effect | Press Stop then Start in Settings |
Building from source
npm install --legacy-peer-deps
npm run build
npm test
npm pack --ignore-scripts
Architecture and behaviour specs live in docs/.
License
MIT
Install
Install the catalog once, then DeepSeek Harness can find and install any plugin from this site automatically:
dsh plugin add dshbase-catalogThen say "install dsh-fingerprint-relay for me" — your agent finds it in the directory and installs it. Docs: dshbase-catalog · verified packs.
This plugin is GitHub source (not published to npm) — install it straight from the repo:
Web profile:
dsh plugin --profile web add github:Wilfred-wei/dsh-fingerprint-relayHeadless (CLI) profile:
dsh plugin --profile headless add github:Wilfred-wei/dsh-fingerprint-relayTest report
Not yet L3-verified — see failure note below if we already ran it.
Share this badge
Drop this badge into your README — it links back here and updates automatically when our test status changes:
[](https://dshbase.com/plugins/dsh-fingerprint-relay/)<a href="https://dshbase.com/plugins/dsh-fingerprint-relay/"><img src="https://dshbase.com/badges/dsh-fingerprint-relay.svg" alt="dshbase listed"></a>