English | 中文
oh-my-deep-seek-harness is a security-review-first downstream distribution of DeepSeek Harness for English-speaking operators and integrators. It intentionally trails upstream when review needs more time.
The distribution prioritizes Pi and Oh My Pi (OMP), Hermes Agent, OpenClaw, and 9Router interoperability. Current integration status distinguishes working paths from compatibility targets.
Important
A reviewed release means its pinned upstream commit passed the checks recorded by this repository. It is not a claim that the software is vulnerability-free. See the security policy and upstream intake policy.
DeepSeek Harness (dsh) is the open-source agent harness developed by DeepSeek AI. The Hermes-oriented product and plugin ideas are inspired by Yuan Chenglu's oh-my-deepseek-harness. See CREDITS.md for full attribution. This downstream project is independent and is not endorsed by either upstream project.
It uses an architecture where everything is a plugin, and is powered by Cordis, whose design is described in A Programming Paradigm for Spatiotemporal Composability.
DeepSeek Harness is currently in developer preview and is iterating rapidly. THERE WILL BE COMPATIBILITY-BREAKING CHANGES.
Note
The reviewed downstream package is @truly-private/omdsh. npm package names are lowercase, so use this spelling even though the GitHub organization is Truly-Private. Pin @0.1.0 to install this release exactly.
This path sends model requests through 9Router. DeepSeek Harness does not need DEEPSEEK_API_KEY; 9Router owns the credentials for the upstream providers and accounts you connect.
Install Node.js ^22.19.0 or >=24.0.0, then verify npm can resolve this distribution:
npx --yes @truly-private/omdsh@0.1.0 webThe command starts the Web UI at http://127.0.0.1:3080 by default and opens it in the default browser for a local launch. An SSH launch only prints the host URL because the SSH client or editor owns the local forwarded address. Pass --no-open to run the server without opening a browser. See Web UI guide.
When the harness repository itself is the workspace, use its source launcher:
git clone https://github.com/Truly-Private/oh-my-deepseek-harness.git
cd oh-my-deepseek-harness
pnpm install
pnpm dsh webpnpm run build prepares the repository artifacts. pnpm dsh web uses those built artifacts without rebuilding.
- Feel free to submit feedback or bug reports through GitHub Discussions.
- Add the
dsh-plugintopic to your plugin repository for discoverability. - Join DeepSeek Harness Discord community.
See CONTRIBUTING.md.
Start with the development guide and architecture documentation.
For agents, follow AGENTS.md.
Third-party dependencies and their licenses are disclosed in THIRD_PARTY_NOTICES.md.