DeepSeek Harness developer preview

655 points - yesterday at 12:58 PM

Source

Comments

tianyicui yesterday at 3:17 PM
Hi I'm one of the authors of DeepSeek Harness. It's just an early developer preview version we're presenting in MIT license currently. Expect lots of rough edges and compatibility-breaking changes. Any feedback and suggestions are more than welcome!
SwellJoe yesterday at 4:30 PM
"Every run is traceable

Everything the model sees is recorded in an append-only session log: system prompts, reasoning, tool calls and results, subagent scheduling, and every context injection. In the Trajectory view, you can inspect these records by source. Resume, fork, search, and replay all operate on the same event stream."

That's a killer feature, IMHO, and one that US models won't allow you to do, as their traces are encrypted, obfuscated, etc. and have to be extracted via various workarounds (that violate the terms of service).

If you want to be able to improve your tools that work with models, you have to be able to assess what the models think is happening, how they think about and interact with the data you give them. And, the US models won't let you see that.

lxdlam yesterday at 2:23 PM
I have read the underlying paper, and found it may be useful, but not that useful.

For those who want to know what it achieves: it adds hot-reload and dynamic enable/dispose capabilities to a plugin system, like the one in Pi agents, though they push the boundaries further, to the UI components and so on.

For those who want to know what it does: if you have some PLT knowledge, ask your agent to explain the algebra to you better; for those who aren't familiar, the framework requires each plugin to provide how it initializes and how it destructs (like C++'s RAII, Rust's Drop trait and so on), and the runtime will then properly handle the lifecycle events and the common pitfalls. In addition, it provides a clean way to declare the dependencies between plugins, and the runtime will also properly process the lifecycle changes on a broader plane.

I think it's worth reading if you are not familiar with OSGi, iPOJO, React's useEffect and so on (which the paper itself mentions); for others, a skim is enough: it does point out the gotchas for some common problems, but the algebra may not help you further.

ef2k yesterday at 4:55 PM
What's buried under the lede: this harness is using Cordis v4 (the paper that dropped today). Cordis has already been used for four years in a different project called Koishi that uses v3. Cordis itself is a way of hot loading and unloading plugins without restarting a running process. The cool part is that when it unloads it can revert any state and side effects it created, cleaning up its connections, memory allocations, registered handlers, etc. and it can also deactivate any dependencies it relied on without disturbing other plugins.
invaliduser yesterday at 2:51 PM
«It uses an architecture where everything is a plugin» Ok, that's enough for me. I have developped over the year a plugin fatigue.

Every product relying on "community plugins" for their features implies it works fine the 6 first months, then it's a nightmare of incompatible, deprecated, incompatible plugins, with no consistency and no governance.

I understand how attractive it can be to companies to think, hey, let's make a very small product and rely on other people to make features, and I hope it works, but I'm personally staying away from that.

rco8786 yesterday at 1:53 PM
But like, what is it? Odd that this reached #1 on HN. The README is pretty bare outside of installation instructions and a link to "Cordis", which is "A Meta-Framework of Spatiotemporal Composability." and "under active development. The API is not yet stable and may change without notice.".
syntaxing yesterday at 1:47 PM
Is there a reason why so many of these agent harness are written in node.js?
vhantz yesterday at 3:52 PM
There is such a clear lack of innovation drive in this field. Every lab just copies what the other does. One of the most baffling things to me is how the once-upon-a-time good developer instinct to make everything reusable, testable, and deterministic is just getting lost into a sea of markdown begging a language model to please act a certain way. For example this repository has a "skill" definition that consists in instructing the LLM to run pre-commit checks. But we have solved this a long time ago, it's called git hooks. I do not understand why they don't simply wire those instructions as testable, reusable, deterministic code routines in the git tool call itself. It's like everybody is taking their brains out and putting it in a drawer.
z_rho_one yesterday at 9:50 PM
Based on what I've read today, DeepSeek Harness seems to be similar to Pi Coding Agent in design. Both are barebones to start out and rely heavily on plugins. However, 3 things make DSH stand out. 1. Plugins in DSH are required to have cleanup handlers, so I guess you could clean up plugins that are no longer used mid-session and prevent it from interfering with the current task? (unsure about this) 2. DeepSeek V4 models are post-trained on DSH. Given how cheap DS V4 is compared to OpenAI and Anthropic models, running DS V4 in DSH could be much more cost-effective while barely losing performance. 3. It's utilized and maintained by a large lab dedicated to open source AI. It's always nice to get new open source tools from large labs so that we are not always relying on small teams doing the heavy lifting.
Kuyawa yesterday at 4:20 PM
I like it, it is beautiful, specially the trajectory tabs, very explicit, detailed on what it does. I like the plugin architecture, I wish they were sorted alphabetically so I don't waste hours looking for a plugin in a sea of unordered text.

9 out of 10

Edit: After creating an app it works as expected, no complains, lots to celebrate, being version 0.1 there is room for more surprises but right now it's the perfect tool for those initiating in agentic coding with one of the most affordable and powerful AI. It is really wonderful.

nycdatasci yesterday at 3:59 PM
Everything is a plugin.

"this, like all other problems in Computer Science, can be solved by one more level of indirection." Roger Needham, circa ~1981

vinhnx yesterday at 1:58 PM
The Cordis plugin architecture is interesting

https://github.com/cordiverse/paper

hmokiguess yesterday at 2:13 PM
Tangential but, are there benchmarks out there on how languages affect latent spaces and performance of these models?

This other day I was looking at that “caveman” skill, and was shocked to see it evolved to become a company, and, in one of its modes, the highest form of compression seems to be “Wenyan” which is Classical Chinese.

Should I get started on learning Chinese?

hahahaa today at 6:28 AM
Problem is I use pi.dev and I don't want to learn a new thing the new things keeping coming. Too much new and unprecidented rate.
gagan2020 yesterday at 4:38 PM
I was working on same idea but left in between and thank god they did it.

Why I left that idea is because as a developer I know that was needed but I have limited time so I need to build that is really next path forward.

I am working on whole dev space that can run on my Mac M4 or similar specs. I needed to revamp everything (LLM thinking) from ground up even models. My idea is mixing deterministic nature of existing tooling (non-LLM tooling) with non-deterministic nature of LLMs.

deleted yesterday at 3:27 PM
flaburgan yesterday at 2:34 PM
Is there a comparison of harness somewhere? Like, the same prompt to the same model, but with different harnesses, and comparing the quality of the results. I am trying to run as much as possible only on free software, so I always only used Zed plugged with anthropic models, but I am wondering what is the quality of Zed harness compared to the one of claude code or pi or others... I would love some feedback.
mring33621 yesterday at 2:59 PM
I just installed DeepSeek Harness with the latest Bun version and am using it with a local 9B, speculative decoding Qwen 3.x variant, running in llama.cpp and it works GREAT for small python projects, so far.

It was very easy to connect the harness to the local model and it seems to run quite fast, compared to other harnesses that I have tried.

try-working yesterday at 8:57 PM
I've been thinking that they should design the DeepSeek harness to work with other providers since a large use case is to off-load work from an expensive model to DeepSeek, instead of makign everyone hack the harness.

I see that it works with many different providers out of the box and that's a great thing. It also makes it easy for me to build a plugin for the role-model router and have it work properly, so you can route between models automatically. Will be out later today.

throwaway7783 today at 5:11 AM
We keep reinventing everything. Eclipse style plugins from a long time back
Gecko4072 yesterday at 2:32 PM
pyrophane yesterday at 1:50 PM
I'm curious what peolle are finding with first party vs 3red party harnesses for coding.

Do the first party harnesses really have an advantage when paired with the maker's model?

jbellis yesterday at 2:33 PM
And that's it, that's the last lab releasing models worth coding with that didn't have a first party harness that its models are trained to use.
addozhang yesterday at 4:06 PM
I personally really like products with plugin systems: a stable, cohesive co with a rich, extensible ecosystem. You can create products that fiyour exact needs, and even if there's no plugin that meets your requirements, you can build it yourself. At least there's vibe coding.

Just like Obsidian, there's also hot loading.

bmurphy1976 yesterday at 2:36 PM
Tracing what it actually did. Who would have thought that's a good idea, instead of trying to obfuscate everything.
deleted yesterday at 2:10 PM
notjes yesterday at 7:30 PM
We can /model, but when can we /harness?
mancerayder today at 12:59 AM
What sorts of questions can we and can't we ask?
prtmnth today at 1:57 AM
Missed opportunity to call it DeepCode
favflam yesterday at 10:29 PM
Is this better than the bytedance cloudwego/eino Go library?
slowin yesterday at 4:08 PM
Is there any place to see benchmarks for harnesses (not models)? I'd love to see these things compared.
aussieguy1234 today at 6:04 AM
My approach to harnesses is:

Everything is a skill, backed by a CLI tool that both I and the agent can use and debug.

Kuyawa yesterday at 3:54 PM
47mb downloaded, 1.5gb after build, wtf?

I consider my own coding agent bloated at just 1mb (yes 1mb) because it uses postgresql package as db tool, and it works wonders.

* edit 1: Upon further scrutiny, 35 dependencies make up for 1.4gb, what they are for? I don't even see postgres in there so I guess that would be another plugin. 1.5gb of basic functionality?

* edit 2: Most of the time I use the terminal but also developed a web ui for my agent [1] and it is only 20mb with postgres, git, web, file tools, etc I definitely want to know why the bloat

[1] https://github.com/kuyawa/mecha-ui

Shorel yesterday at 3:35 PM
Awesome, let's read what they have done! I open a new tab.

To install the harness, first use npm...

And tab is closed. No thanks.

Founderarcstone today at 5:43 AM
nice very good to see this.
jimmydoe yesterday at 3:59 PM
Spatiotemporal Composability... CORDIS... sounds like a few doctor who fans in deepseek
deleted yesterday at 2:45 PM
KronisLV yesterday at 7:10 PM
Everything is a plugin? I'm reminded of Eclipse!
217 yesterday at 1:45 PM
if it's not better than omp im not trying it
alansaber yesterday at 5:01 PM
Code mode getting some love.
yipinwong yesterday at 2:36 PM
Good idea, ugly landing page
tw1984 today at 4:11 AM
not very impressed.

in the era of AI, telling me that the core design is a plugin system that can be reloaded and extended easily is just not exciting.

it is something you feel excited 20 years ago back in the 2000s, in 2026, the expectation is agentic capabilities and self improving.

tosh yesterday at 3:11 PM
often new harnesses are based on pi

this looks like a genuinely new one

phront yesterday at 3:34 PM
hmm.. what about supply chain security?
satonakamoto yesterday at 3:43 PM
lenerdenator yesterday at 4:13 PM
As someone who's just getting into the self-hosted game on a M2 Pro MBP with muse-glimmer 30b, what's the difference between something like this and Cline?
0xbadcafebee yesterday at 2:53 PM
> It uses an architecture where everything is a plugin

Did they discover Unix pipes?

m00dy yesterday at 1:48 PM
it looks like we're leaving md files and instead use cordis plugins ?
laul_pogan yesterday at 3:45 PM
Trying it now, seems a little sloppy...
WhereIsTheTruth yesterday at 2:25 PM
In the age of LLMs, if your new hires are pushing npm slop, with all the cargo culting and security pwn issues it brings, your hiring process has failed you

oof

aratahikaru5 yesterday at 1:49 PM
The landing page provides more context than GitHub: https://deepseek.com/harness/en/

The documentation, built from repo, is available here: https://deepseek-harness.github.io/deepseek-harness/en/guide... (I find the development and reference sections easier to read and navigate)

williamjinq today at 1:40 AM
[flagged]
sha2kyou today at 7:47 AM
[dead]
bobleer yesterday at 1:40 PM
[flagged]
brookritz yesterday at 2:32 PM
[dead]
throwa356262 yesterday at 2:14 PM
[dead]
yunbiao yesterday at 1:24 PM
[flagged]
fkysly yesterday at 2:16 PM
[flagged]
doumiBou today at 7:02 AM
[dead]
fkysly yesterday at 5:04 PM
[dead]
salathielzhang yesterday at 4:34 PM
[dead]
ohyoutravel yesterday at 1:48 PM
[flagged]
catigula yesterday at 1:51 PM
[flagged]
huqedato yesterday at 3:13 PM
Please somebody explain what is this good for. Is it a similar tool with Claude Code or Antigravity ?
cedws yesterday at 3:31 PM
Guh, why TypeScript? If code is free now why would you choose a transpiled language with a huge runtime and nightmare security over something fast and lean?