1# DeepSeek Harness

2

3English | [中文](README.zh.md)

4

5DeepSeek Harness (`dsh`) is an open-source agent harness developed by [DeepSeek AI](https://deepseek.com).

6

7It is built on an **everything-is-a-plugin** architecture and powered by [Cordis](https://github.com/cordiverse/cordis), whose design is described in [_A Programming Paradigm for Spatiotemporal Composability_](https://arxiv.org/abs/2608.25512).

8

9Documentation: [https://deepseek-harness.github.io/deepseek-harness/](https://deepseek-harness.github.io/deepseek-harness/)

10

11## Developer preview

12

13DeepSeek Harness is in _developer preview_ and iterating rapidly. **THERE WILL BE COMPATIBILITY-BREAKING CHANGES.**

14

15Review the [safety notice](SAFETY.md) before running the project.

16

17## Run

18

19### Run from `npm`

20

21Install `Node.js`, then run:

22

23```sh

24npx @deepseek-ai/dsh web

25```

26

27The 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](docs/user/guide/index.md).

28

29### Run from source

30

31To run from a repository checkout:

32

33```sh

34git clone https://github.com/deepseek-ai/deepseek-harness.git

35cd deepseek-harness

36pnpm install

37pnpm run build

38pnpm dsh web

39```

40

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

42

43## Community and support

44

45- Submit feedback or bug reports through [GitHub Discussions](https://github.com/deepseek-ai/deepseek-harness/discussions).

46- Add the [`dsh-plugin`](https://github.com/topics/dsh-plugin) topic to your plugin repository for discoverability.

47- Join <a href="https://discord.gg/4MrtZUhpxg">DeepSeek Harness Discord community</a>.

48

49## Contributing

50

51See [CONTRIBUTING.md](CONTRIBUTING.md).

52

53## Development

54

55Start with the [development guide](docs/development.md) and [architecture documentation](docs/architecture.md).

56

57`pnpm run dev:web` builds, serves, and rebuilds client bundles on source edits in one terminal, and `make help` lists the matching Make targets for Web and Desktop; the guide's application commands section owns the full table.

58

59For agents, follow [AGENTS.md](AGENTS.md).

60

61## Citation

62

63```bibtex

64@misc{deepseek-harness2026,

65 title={DeepSeek Harness: Everything is a Plugin},

66 author={DeepSeek-AI},

67 year={2026},

68 publisher={GitHub},

69 howpublished={\url{https://github.com/deepseek-ai/deepseek-harness}},

70}

71```

72

73## License

74

75[MIT](LICENSE)

76

77Third-party dependencies and their licenses are disclosed in [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).