kevchess15/deepseek-harness
1
1
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1
2nd dokployH
13163 commits 1 branch 9 tags 143 MiB
Find a file
imccyu 4e6937064c fix(util): mint the pinned uuid bytes without dead fallback branches
2026-08-21 20:35:35 +08:00
.agents ci: add build-preview workflow 2026-08-21 20:35:33 +08:00
.claude docs: accuracy sweep, architecture restructure, two ADRs, review skill 2026-06-13 22:05:34 +08:00
.github ci: put the preview-comment marker on its own line 2026-08-21 20:35:34 +08:00
apps test: follow the uuid mint to its new entropy seam 2026-08-21 20:35:34 +08:00
docs fix: loopback 2026-08-21 20:35:34 +08:00
examples fix(llm-deepseek): fall back when Files resolution fails 2026-08-21 18:14:46 +08:00
native docs(i18n): localize Chinese internal links 2026-08-18 19:00:37 +08:00
packages fix(util): mint the pinned uuid bytes without dead fallback branches 2026-08-21 20:35:35 +08:00
patches chore(subprocess-local): bump node-pty beta 2026-08-13 17:58:13 +08:00
python chore(images): align merged runtime closure 2026-08-21 15:05:54 +08:00
scripts fix: loopback 2026-08-21 20:35:34 +08:00
vendor release(vendor): cordis 4.0.1, cosmokit 1.8.2, group 1.0.1, hmr 1.0.16, include 1.0.6, loader 1.0.2, logger-console 1.0.1, schemastery 3.18.1, timer 1.1.3 2026-08-13 14:18:56 +08:00
website Merge pull request #2739 from deepseek-harness/xtr/speed-up-doc-sync 2026-08-21 12:36:36 +08:00
.editorconfig Declare LF and final-newline conventions in .editorconfig 2026-07-15 16:09:12 +08:00
.gitattributes feat(i18n): compose pairing records during merges 2026-08-08 21:11:59 +08:00
.gitignore feat(build): bind client artifacts to build profiles 2026-08-19 18:21:27 +08:00
.gitlab-ci.yml Support MCP in packaged Python runtime 2026-08-18 13:50:53 +08:00
.jscpd.json chore(lint): bring .tsx files into the eslint, lefthook, and jscpd lanes 2026-07-27 21:42:08 +08:00
.oxlintrc.json feat(util): mint UUIDs without crypto.randomUUID in every context 2026-08-21 20:35:34 +08:00
.oxlintrc.staged.json refactor: make lint workflows Oxlint-only 2026-08-09 14:55:15 +08:00
.rgignore chore: exclude archived Agent Notes from rg 2026-08-10 14:49:30 +08:00
AGENTS.md feat(authorization): obtain a credential by asking the human 2026-08-20 17:58:38 +08:00
BENCHMARK.md docs: make Web UI the primary onboarding path 2026-08-12 11:44:33 +08:00
BRAND_GUIDELINES.i18n.yaml docs: split brand guidelines into bilingual pair 2026-08-19 21:01:18 +08:00
BRAND_GUIDELINES.md docs: split brand guidelines into bilingual pair 2026-08-19 21:01:18 +08:00
BRAND_GUIDELINES.zh.md docs: split brand guidelines into bilingual pair 2026-08-19 21:01:18 +08:00
CLAUDE.md Initialize repo with README, AGENTS.md, and CLAUDE.md symlink 2026-06-10 22:58:56 +08:00
CONTRIBUTING.i18n.yaml docs(i18n): polish contribution greeting 2026-08-12 14:40:32 +08:00
CONTRIBUTING.md docs(i18n): refine contribution guide wording 2026-08-12 14:24:44 +08:00
CONTRIBUTING.zh.md docs(i18n): polish contribution greeting 2026-08-12 14:40:32 +08:00
knip.json feat(webworker): browser worker host runtime and the vfs image packer 2026-08-21 20:35:32 +08:00
lefthook.yml fix(review): address source-run feedback 2026-08-11 11:22:08 +08:00
LICENSE Adopt MIT for DSH packages 2026-08-13 13:07:24 +08:00
package.json release(dsh): 0.1.1-rc.2 2026-08-21 19:48:58 +08:00
pnpm-lock.yaml fix: loopback 2026-08-21 20:35:34 +08:00
pnpm-workspace.yaml chore(subprocess-local): bump node-pty beta 2026-08-13 17:58:13 +08:00
pytest.ini Merge remote-tracking branch 'origin/master' into codex/trim-ai-prose 2026-07-14 00:40:36 +08:00
README.i18n.yaml Merge remote-tracking branch 'origin/master' into codex/localized-chinese-doc-links 2026-08-20 19:15:33 +08:00
README.md feat(web,cli): open the ready Web UI by default 2026-08-19 15:42:12 +08:00
README.zh.md Merge remote-tracking branch 'origin/master' into codex/localized-chinese-doc-links 2026-08-20 19:15:33 +08:00
THIRD_PARTY_NOTICES.md feat(webworker): browser worker host runtime and the vfs image packer 2026-08-21 20:35:32 +08:00
tsconfig.base.client.json feat(client): inject public build environment 2026-08-19 18:21:26 +08:00
tsconfig.base.json feat(util): mint UUIDs without crypto.randomUUID in every context 2026-08-21 20:35:34 +08:00
tsconfig.client.json feat(client): compose deployment branding through slots 2026-08-19 18:21:35 +08:00
tsconfig.host.json feat(util): mint UUIDs without crypto.randomUUID in every context 2026-08-21 20:35:34 +08:00
tsconfig.json refactor(tsconfig): single root solution graph over host/client aggregates 2026-07-23 03:59:05 +08:00
tsdown.config.ts refactor: apply repository naming contract 2026-08-13 00:54:38 +08:00
vitest.config.ts feat(webworker): model-executed shell over nested worker processes 2026-08-21 20:35:32 +08:00
vitest.e2e.config.ts fix(typert): close remote gateway review gaps 2026-08-07 21:47:15 +08:00
vitest.shared.ts fix(typert): close remote gateway review gaps 2026-08-07 21:47:15 +08:00
vitest.snapshot.config.ts chore: remove remaining SDK toolchain residue 2026-08-11 16:37:29 +08:00
vitest.web-stress.config.ts test(web): add opt-in reasoning chunk stress lane 2026-08-04 14:37:31 +08:00
vitest.web.config.ts perf(ci): parallelize coverage and web snapshots in-job 2026-08-18 21:15:20 +08:00
vitest.web.perf.config.ts test: add opt-in web performance scenario 2026-08-04 14:23:34 +08:00

README.md

DeepSeek Harness

English | 中文

DeepSeek Harness (dsh) is an open-source agent harness developed by DeepSeek AI.

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.

Developer preview

DeepSeek Harness is currently in developer preview and is iterating rapidly. THERE WILL BE COMPATIBILITY-BREAKING CHANGES.

Run

Run from npm

Install Node.js, then run:

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. 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.

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

pnpm run build prepares the repository artifacts. pnpm dsh web uses those built artifacts without rebuilding.

Community and support

Contributing

See CONTRIBUTING.md.

Development

Start with the development guide and architecture documentation.

For agents, follow AGENTS.md.

License

MIT

Third-party dependencies and their licenses are disclosed in THIRD_PARTY_NOTICES.md.