![dsh-edge — Your DeepSeek Harness, anywhere. Deploy to Cloudflare in one command.](docs/assets/dsh-edge-hero.jpg) [![npm](https://img.shields.io/npm/v/dsh-edge)](https://www.npmjs.com/package/dsh-edge) [![CI](https://github.com/pawaca/dsh-edge/actions/workflows/edge-ci.yml/badge.svg)](https://github.com/pawaca/dsh-edge/actions/workflows/edge-ci.yml) [![License: MIT](https://img.shields.io/github/license/pawaca/dsh-edge)](LICENSE) English | [中文](README.zh.md) `dsh-edge` runs the published DeepSeek Harness Web experience on Cloudflare Workers, so your personal coding agent is available wherever you have a browser. No server to maintain, GitHub repository to connect, or build pipeline to configure. It keeps the upstream UI, agent loop, model selection, and Web Search, while adding goal tracking, file operations, context compaction, runtime-configurable settings, and persistent multi-workspace management — all on Cloudflare Workers. > **Independent community project:** `dsh-edge` is maintained by [pawaca](https://github.com/pawaca). It is not affiliated with or endorsed by DeepSeek. [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) is the upstream project. ## Start in one command You need Node.js 22.14 or newer and your own DeepSeek API key: ```sh npx dsh-edge install ``` Press Enter at every prompt to deploy the Worker and open it in your browser, then add your DeepSeek API key when the web app asks (or later in Settings → Models). You can try it without an existing Cloudflare login, or install it permanently in your own Cloudflare account. No source checkout is required. [![Install dsh-edge, unlock the deployment, select Vision Exp, and analyze an image](docs/assets/dsh-edge-demo.gif)](docs/assets/dsh-edge-demo.mp4) ## What you get - **Agent capabilities** — goal tracking with GoalBar UI, file tools (read, write, edit, read_image), context compaction for long conversations, and automatic session titles. - **Workspaces** — multiple persistent workspaces with create, rename, archive, and reorder; a `/workspace` filesystem backed by Durable Object SQLite; and a bash tool with configurable timeouts. - **Models** — DeepSeek V4.1 Flash (with image input) and V4 Pro through the upstream selector; runtime-configurable settings (model, API key, reasoning effort) without redeployment; Web Search and PNG/JPEG image input. - **Conversations** — session fork to branch conversations, queue/steer message editing, persistent history from any browser. - **Deployment** — your own Cloudflare Worker, credentials, and data; in-place upgrades without a repository or build pipeline. ## Choose your deployment | Path | What you need | Best for | | --- | --- | --- | | **Try now** | No existing Cloudflare login; claim within 60 minutes to keep it | Exploring the complete experience with the lowest friction | | **Keep it** | An existing or new Cloudflare account | A long-lived personal deployment | The installer asks what your agent should be able to do. Each choice includes the ones before it: - **Research and write** (Workers Free): search the web, read pages, draft docs, and connect your tools through MCP. Commands run in a lightweight shell (just-bash, a sandboxed shell for file and text work, not Linux) inside the instance. - **+ Analyze data and split big jobs** (Workers Paid, from $5/month): runs that shell in an isolated Worker and adds `workflow` (parallel subagents), plus `run_code` (a TypeScript program that calls the other tools) in sessions started in the PTC mode agent preset, which, like upstream, does not offer `workflow`. - **+ Work on code projects** (Workers Paid plus container time): adds a real Debian container with git, node, npm, and python3. Each command still starts in the lightweight shell; only a command that needs Linux (or that the agent marks with `linux: true`) runs in the container, which starts on demand, sleeps after 10 idle minutes by default (adjustable in Settings), and is billed by Cloudflare while it runs. All choices share the same UI, conversations, workspace, images, and subagents. ## Upgrade ```sh npx dsh-edge upgrade ``` The installer finds your Worker and upgrades it in place, keeping its capabilities, durable data, and keys unless you choose to change what it can do. Running `install` again with the same Worker name does the same. See the [release notes](docs/releases/) for version-specific details. ## Important boundaries - dsh-edge is designed for one owner; it does not provide registration, multiple users, roles, or tenant routing. - Your DeepSeek key is stored as a Worker secret when set at deployment, or in Durable Object storage when configured through the runtime Settings UI. The deployment's durable data stays in your Cloudflare account. - MCP over Streamable HTTP is available on all deployment tiers; stdio MCP is not supported. Container deployments can run native Linux programs through bash, but the upstream subprocess service and persistent interactive PTY sessions are not provided. See the [compatibility matrix](apps/dsh-edge/README.md#cloudflare-compatibility-matrix) and the [wiki](https://github.com/pawaca/dsh-edge/wiki) for the full status. ## Built on DeepSeek Harness dsh-edge wraps exact published DeepSeek Harness packages instead of copying its monorepo. Upstream remains responsible for the Web UI, plugin composition, agent loop, and session protocols; this repository implements the Cloudflare runtime and storage adapters needed to run them at the edge. For the upstream architecture and plugin APIs, see the [DeepSeek Harness repository](https://github.com/deepseek-ai/deepseek-harness) and [reference documentation](https://deepseek-harness.github.io/deepseek-harness/reference/). ## Documentation - [Architecture and subsystem wiki](https://github.com/pawaca/dsh-edge/wiki) - [Runtime reference, compatibility, security, and limits](apps/dsh-edge/README.md) - [Release notes](docs/releases/) - [DeepSeek Harness upstream documentation](https://deepseek-harness.github.io/deepseek-harness/reference/) ## Develop locally Source checkout is only required for development. The repository toolchain requires Node.js `^22.19.0` or `>=24.0.0`: ```sh git clone https://github.com/pawaca/dsh-edge.git cd dsh-edge pnpm install pnpm --dir apps/dsh-edge/standalone install --frozen-lockfile pnpm run check ``` See the [local Edge setup](apps/dsh-edge/README.md#run-locally) to run the Worker locally. ## Contributing and support - Report dsh-edge bugs and installation problems in [Issues](https://github.com/pawaca/dsh-edge/issues). - Report vulnerabilities through the [private security process](SECURITY.md), not a public Issue. - Follow [CONTRIBUTING.md](CONTRIBUTING.md) and [AGENTS.md](AGENTS.md) when changing the repository. ## License [MIT](LICENSE). Third-party components and their licenses are listed in [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).