DeepSeek Harness
DeepSeek Harness (dsh) is an open-source agent harness from DeepSeek AI, built on an everything-is-a-plugin architecture powered by Cordis. It provides a Web UI for running agents locally or via SSH, aimed at developers building and orchestrating AI agents. It is currently in developer preview with rapid iteration and potential breaking changes.
🎬 DeepSeek Harness Setup: A Free Claude Code You Own In 10 Minutes · Sharbel A.
✨ Key features
- Everything-is-a-plugin architecture powered by Cordis
- Web UI for local or SSH launches
- Runs via npx or from source
- Open-source under MIT license
- Documentation and development guides available
🎯 Use cases
- Run an agent harness locally with a Web UI
- Launch agent sessions via SSH
- Develop custom plugins for agent orchestration
- Explore agent harness architecture and composability
📦 Installation
🧰 Requirements: Requires Node.js and optionally pnpm for source builds; no API keys mentioned.
Run from npm
Install Node.js, then run:
npx @deepseek-ai/dsh web
Run from source
To run from a repository checkout:
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web
🚀 Usage
npx @deepseek-ai/dsh web
The 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. Pass --no-open to run the server without opening a browser.
⚠️ Good to know
DeepSeek Harness is in developer preview and iterating rapidly; there will be compatibility-breaking changes. Review the safety notice before running.
❓ FAQ
How do I start the Web UI?
Run npx @deepseek-ai/dsh web after installing Node.js. It starts at http://127.0.0.1:3080 by default and opens in your browser.
Can I run it without opening a browser?
Yes, pass the --no-open flag to run the server without opening a browser.
How do I run from source?
Clone the repository, then run pnpm install, pnpm run build, and pnpm dsh web.
Is it stable for production?
No, it is in developer preview and may have compatibility-breaking changes. Review the safety notice before running.
📊 Repository
🤖 Overview, features, install steps and FAQ were generated from the project's README on Sep 4, 2026. Always check the original source before running commands.