deepseek-harness README

The project's README from github.com/deepseek-ai/deepseek-harness. As one markdown file: README.md.

DeepSeek Harness

English | 中文

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

It is built on an everything-is-a-plugin architecture and powered by Cordis, whose design is described in A Programming Paradigm for Spatiotemporal Composability.

Documentation: https://deepseek-harness.github.io/deepseek-harness/

Developer preview

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

Review the safety notice before running the project.

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.

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.

For agents, follow AGENTS.md.

Citation

@misc{deepseek-harness2026,
  title={DeepSeek Harness: Everything is a Plugin},
  author={DeepSeek-AI},
  year={2026},
  publisher={GitHub},
  howpublished={\url{https://github.com/deepseek-ai/deepseek-harness}},
}

License

MIT

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

deepseek-harness (deepseek-ai/deepseek-harness)

Searching Database…

Что это такое?DeepSeek Harness (dsh) — это агентный харнесс с открытым исходным кодом от DeepSeek AI, построенный полностью на архитектуре «всё — это плагин» и работающий на движке компонуемости Cordis.
Это фреймворк, под который я пишу код, или самостоятельная программа, которую я запускаю?Это готовая к запуску программа: при старте dsh поднимается локальный сервер с Web UI, и буквально всё внутри, включая сам интерфейс, реализовано как заменяемый плагин поверх движка Cordis.
Как это запустить?Установите Node.js, затем запустите dsh из npm: он поднимет сервер и автоматически откроет Web UI в браузере. Чтобы запустить из исходников (клонированного репозитория), выполните pnpm run build, а затем pnpm dsh web.
Что нужно установить перед тем, как попробовать?Нужен только Node.js (версии 22.19.0+ или 24.0.0+); для сборки из репозитория дополнительно понадобится pnpm, чтобы сначала собрать артефакты.
Можно ли уже сейчас строить на этом что-то стабильное?Нет: это явно ранняя версия для разработчиков, которая быстро развивается, и мейнтейнеры предупреждают о будущих изменениях, ломающих совместимость, поэтому перед запуском стоит прочитать предупреждение о безопасности.
Для кого это предназначено?Для авторов плагинов и разработчиков агентов, которые расширяют харнесс DeepSeek; проект даже просит авторов плагинов помечать свои репозитории тегом, чтобы их было легче находить.
Что такое Cordis?Cordis — это движок компонуемости, на котором держится архитектура плагинов dsh; его устройство описано в статье «A Programming Paradigm for Spatiotemporal Composability».
Будет ли работа отличаться, если запускать через SSH?Да: в SSH-сессии dsh лишь выводит адрес хоста вместо открытия браузера, поскольку перенаправленный локальный адрес принадлежит SSH-клиенту или редактору. Также на любом компьютере можно передать --no-open, чтобы не запускать браузер.
Есть ли что-то помимо Web UI?В скриптах сборки, помимо build:web, есть отдельная цель build:desktop, что говорит о разработке десктопного клиента наряду с браузерным Web UI.
Зачем помечать репозиторий тегом dsh-plugin?Это принятое в DeepSeek Harness соглашение: так авторы плагинов из сообщества делают свои плагины заметными для других пользователей dsh.
Size
285.8 MB
Stars
252.1K
Updated
CommitOct 17
Age
2mo
Commits · 90 Days