npx
Quick try
@deepseek-ai/dsh web → :3080
Official
DeepSeek Harness developer preview entry and local agent map
DeepSeek Harness turns a model into a working agent on your machine. Use this page to orient, then follow install for the first launch and modes before you load community packages.
- Open source MIT
- One-command npx try
- Runs on localhost
One command to start the local Web UI — copy and run in your terminal
npx @deepseek-ai/dsh web Cordis
Composition
Load, unload, wire plugins
4 modes
Presets
Standard · PTC · Minimal · Creative
Plugins
Extensibility
Model, tools, sandbox, UI skins
What DeepSeek Harness is (and is not)
Public materials describe DeepSeek Harness as a locally running coding agent with a Web UI, not a chat toy that only echoes. You point it at a workspace, choose a run mode, and the Agent Loop drives tools through plugins. Capabilities are not hard-wired into a monolith: models, tools, sandboxes, UI skins, and providers register through Cordis. That is why “everything is a plugin” shows up in architecture and the plugin guide.
Developer preview means flags and package surfaces move. Pin what you tested. Prefer the GitHub README when a blog date on this site lags. For a first launch, use a disposable folder — not your entire home directory — as the install page warns.
Product framing also lives on deepseek.com/harness. Source, examples, and releases live in deepseek-ai/deepseek-harness. The runnable package is @deepseek-ai/dsh. This portal rewrites operator paths in English and locales; it does not replace upstream materials when wording conflicts.
Why operators start here
One map before the first npx
Know what DSH is, where GitHub / npm / Web UI fit, and which portal pages own install versus discovery — so you do not invent a second manual.
Local work, not only chat
The harness connects files, terminal, and tools so the model can act in a real workspace instead of stopping at a transcript.
Composable surface area
Cordis plugins let you swap providers, tools, and skins without forking core — expand only after Trajectory looks boring.
Honest upstream pointers
Commands and APIs follow GitHub and npm. This site links install, modes, tutorials, and curated plugins without inventing star ratings.
A practical first hour
-
1
Confirm Node, then install
Need Node.js ^22.19.0 or >=24.0.0. Follow [install](/en/install/) end to end — do not skip the workspace warning.
-
2
Open Web UI safely
Configure model credentials and a narrow folder. See the [Web UI guide](/en/dsh/web-ui-guide/) for port 3080 and first-task hygiene.
-
3
Pick a careful mode
Stay in Minimal or careful Standard until Trajectory is dull. Read [modes](/en/modes/) before Creative labs.
-
4
Add plugins later
Browse the [curated directory](/en/plugins/directory/) only after core flows work. Port conflicts belong on [troubleshoot](/en/troubleshoot/).
Go deeper
Official introduction and entry for the DeepSeek Harness developer preview.
Product shape in one pass
Think of DeepSeek Harness as Agent = Model + Harness. The model proposes; Cordis-mounted plugins execute tools and keep session state. Skins and sandboxes load the same way tools do — that is the design bet behind DSH.
When you need chapter form, open tutorials. When you need sibling resource cards, return to the DSH resources hub. Corrections to this portal: contribute.
Official materials vs this portal
Start with deepseek.com/harness for product framing and with GitHub for engineering truth. Package identity lives on the npm spoke; full HowTo stays on install so flags do not fork.
Site-level questions (including “is this DeepSeek HQ?”) belong in FAQ. Product bugs belong upstream with Node version, package version, and full CLI output.
Where plugins and Cordis fit
After the UI is stable, read the plugin guide. Breadth discovery uses the dsh-plugin topic; community awesome-lists are covered on code-directory. Kernel habits: Cordis. Runtime map: architecture.
Failure modes to expect early
Port 3080 already in use, engines mismatch, blank localhost pages, and oversized workspaces are common. Stay on troubleshoot instead of rewriting install here. Pin the npm tag you validated; developer preview moves.
FAQ
Is harness-ds.com the DeepSeek product headquarters?
No. Product framing belongs on deepseek.com/harness. This portal is a community guide map: install, modes, tutorials, and plugin notes. Always verify commands against the GitHub README.
What should I run first?
Use the steps on install. The usual preview launch is npx @deepseek-ai/dsh web. Then configure model and workspace in the Web UI guide.
Where do plugins fit?
After the base UI is stable. Read the plugin guide, then the curated directory. Discovery also happens via the dsh-plugin topic.
Which mode should a new operator pick?
See modes. Many people start careful and expand; Creative is for Cordis experiments, not payroll trees.
Is DeepSeek Harness a new model?
No. Agent = Model + Harness: the model reasons; DSH connects environment and tools. More aliases and clarifications live on FAQ.
When you are ready to run something local, go to install. For product wording from the publisher, open deepseek.com/harness. Sibling pages stay linked under DSH resources.
More curated DSH resources
Each card opens a full landing page — same hub, different job.
- GH Official
deepseek-ai/deepseek-harness
Official MIT open-source repository with source, examples, contribution history, and releases.
Open resource ↗ - npm Official
@deepseek-ai/dsh
Official @deepseek-ai/dsh npm package for launching the local Web UI.
Open resource ↗ - UI Official
DSH Web UI Guide
Official getting-started notes: configure a model, pick a workspace, run the first task.
Open resource ↗ - DOC Official
DSH Architecture
Technical docs on Cordis, plugins, services, session state, and the Agent Loop.
Open resource ↗ - CO Independent community
Cordis
Spatiotemporal composition framework and plugin service model underneath DSH.
Open resource ↗ - PLG Independent community
dsh-plugin on GitHub
GitHub projects tagged dsh-plugin — check maintainers and code quality before use.
Open resource ↗ - DIR Independent community
DeepSeek Code Directory
Independent community directory of DSH plugins, tools, and infrastructure by category.
Open resource ↗
Continue from the overview
Install DSH, skim architecture and Cordis, or open the Web UI guide before you load community plugins.