deepseek-harness

DeepSeek AI has released **DeepSeek Harness** (`dsh`), an open-source agent harness designed around a strict "everything-is-a-plugin" paradigm. If you follow agent runtime design, you will recognize the underlying foundation: it is built on Cordis, drawing directly from the architectural principles outlined in *A Programming Paradigm for Spatiotemporal Composability*. Keep in mind that `dsh` is currently in developer preview and under rapid iteration, so compatibility-breaking changes are expected. Be sure to review `SAFETY.md` before executing host tasks. ### Architecture Under the Hood The core philosophy behind `dsh` is complete modularity. Rather than locking developers into a monolithic engine, the harness relies on Cordis to handle lifecycle management and composition through plugins. By enforcing an architecture where every functionality is modularized, `dsh` remains minimal at its core while allowing deep customization. The project actively encourages community extensions—creators can publish plugins and tag their repositories with `dsh-plugin` on GitHub for discoverability within the ecosystem. --- ### Setup and Local Execution You can run `dsh` either instantly through `npx` or directly from source using `pnpm`. #### Option 1: Quick Start via `npm` If you have Node.js installed, you can spin up the Web UI runtime using `npx`: ```sh npx @deepseek-ai/dsh web ``` By default, this command launches the Web UI server at `http://127.0.0.1:3080` and automatically opens your default local browser. *Note on SSH setups:* If you execute this over an SSH connection, `dsh` detects the remote session and only prints the host URL, leaving port forwarding management to your editor or SSH client. To prevent automatic browser launches during local runs, pass the `--no-open` flag. #### Option 2: Running from Source For direct codebase contributions or local debugging, clone the repository and build the workspace using `pnpm`: ```sh git clone https://github.com/deepseek-ai/deepseek-harness.git cd deepseek-harness pnpm install pnpm run build pnpm dsh web ``` Running `pnpm run build` compiles the required repository artifacts. Subsequently running `pnpm dsh web` spins up the local interface using those pre-built artifacts without triggering an unnecessary rebuild cycle. --- ### Technical Takeaway DeepSeek Harness offers an interesting look into plugin-centric agent composition. The project is licensed under MIT, with third-party notices documented in `THIRD_PARTY_NOTICES.md`. If you are looking to build extensible agent tooling or experiment with Cordis-based composability, `dsh` provides a flexible, modular foundation to start building on. Community discussions, feedback, and support are actively managed via GitHub Discussions and their Discord server.