Tools/deepseek-ai/deepseek-harness

DeepSeek Harness

DeepSeek Harness: Everything is a Plugin.

168.3kestablishedTypeScript

The Lens

By Erik Loyd, SaaS CEO and former COO/CFO of an AWS Premier Partner.

Updated Aug 2026

DeepSeek Harness is DeepSeek's own agent runtime, the layer that sits between a model and your machine and gives it tools, memory, skills, and an interface. The architecture is one idea taken all the way: everything is a plugin. Models, tools, session storage, sandboxes, scheduling, even the agent loop itself are plugins composed into profiles, so you can swap almost any piece without forking the project. MIT licensed and free.

Running it is one command, npx @deepseek-ai/dsh web, which needs Node and serves a web UI on localhost port 3080. Building from source is a pnpm install and build. There is no server to operate: it runs on your machine and calls out to whichever provider you configure. A plugin ecosystem formed within days of launch, including native desktop wrappers and a terminal UI, all discoverable through the dsh-plugin topic on GitHub.

The harness costs nothing and the model calls are the only bill. DeepSeek's own API is cheap by frontier standards: V4-Pro is $1.32 per million input tokens and $3.96 per million output at peak, and exactly half that off-peak. Solo developers: free, and worth an evening if composable systems appeal to you. Small teams: free, but pin your version and mean it. Large teams: watch it rather than standardize on it.

The catch, and DeepSeek puts it in capital letters in their own README: this is a developer preview and there will be compatibility-breaking changes. The plugin API you build against this month may not exist next month. The popularity is real and so is the churn, so treat anything you write on top of it as disposable until the interfaces settle.

Free vs Self-Hosted vs Paid

fully free

Free tier: The entire harness. MIT licensed, published by DeepSeek AI, no account, no hosted tier, no paid edition.

Self-hosted: The only mode, and it is genuinely light. Node.js is the one requirement. npx @deepseek-ai/dsh web serves a local web UI on 127.0.0.1:3080; running from a source checkout is a pnpm install and build. Everything runs on your machine, so there is no infrastructure line item at all.

Paid: No product to buy. The cost is model inference. DeepSeek V4-Pro bills $1.32 per million input tokens and $3.96 per million output at peak hours (01:00 to 04:00 and 06:00 to 10:00 UTC), and half those rates the rest of the day. V4-Flash is roughly a third of Pro. The plugin architecture means you can point it at another provider or a local model instead.

The real cost: churn. The project is in developer preview and states plainly that breaking changes are coming. Budget engineering time for keeping plugins and profiles working across upgrades, not for a license.

Free and MIT. The harness costs nothing; the model tokens behind it do, and DeepSeek's own rates are among the cheapest available.

What to do by team size

Solo
free
Small team
free; pin a version, the API is still moving
Medium team
free, but treat plugin code you write as disposable for now
Large team
Watch it; a developer preview is a poor fit for a standardized fleet
Self-hosting ops:trivial

Get tools like this every Wednesday

One featured tool, three on the radar. No fluff.

Similar Tools

Score
75/100 · B+
Adoption30/30
Maintenance25/25
Community5/20
License5/15
Analysis10/10

A low score is not a verdict on quality. Young and niche tools start low by design. How we calculate scores

About

Owner
deepseek-ai (Organization)
Stars
168,345
Forks
18,016

Explore Further

More tools in the directory