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/
Three files required -start.sh -dockerfile -nigix
┌──────────────────────┐
Internet ──────────►│ nginx :7860 │
│ 0.0.0.0 │
└──────────┬───────────┘
│
│ proxy
▼
┌──────────────────────┐
│ DSH :3080 │
│ 127.0.0.1 ONLY │
└──────────────────────┘
Internet
│
│ HTTP/HTTPS
▼
┌──────────────────────────┐
│ nginx :7860 │
│ 0.0.0.0 │
│ PUBLIC │
└────────────┬─────────────┘
│
│ reverse proxy
▼
┌──────────────────────────┐
│ DSH :3080 │
│ 127.0.0.1 ONLY │
│ INTERNAL │
└──────────────────────────┘
│
│ outbound API requests
▼
┌───────────────────────┐
│ Remote LLM Providers │
├───────────────────────┤
│ Groq │
│ Gemini │
│ Cerebras │
│ SiliconFlow │
│ ModelScope │
│ Z.ai │
│ DashScope │
│ Qianfan │
│ Volcengine │
│ OpenRouter │
│ etc. │
└───────────────────────┘
DSH
│
Free Provider Pool
│
┌─────────────┼─────────────┐
│ │ │
WESTERN CHINESE AGGREGATORS
│ │ │
Groq SiliconFlow OpenRouter
Cerebras ModelScope LLM7
Gemini Z.ai
Mistral DashScope
SambaNova Qianfan
Cohere Volcengine
│ │
└─────────────┴─────────────┘
│
Optional providers
│
HF / Agnes / NVIDIA
│
Local llama.cpp
- create a empty docker file and add this
FROM node:22-bookworm
ENV DEBIAN_FRONTEND=noninteractive
RUN apt-get update && \
apt-get install -y \
git \
curl \
ca-certificates \
nginx \
&& \
rm -rf /var/lib/apt/lists/*
RUN corepack enable && \
corepack prepare pnpm@11.7.0 --activate
WORKDIR /app
RUN git clone \
--depth 1 \
https://github.com/innokria/deepseek-harness.git \
deepseek-harness
WORKDIR /app/deepseek-harness
RUN pnpm install
RUN pnpm run build
ENV DSH_HOME=/data/dsh
ENV DSH_HOST=127.0.0.1
ENV DSH_PORT=3080
ENV PORT=7860
# Override the trusted host from the repo's start.sh
ENV DSH_TRUSTED_HOST=rahul7star-deepseek-harness-v2.hf.space
RUN mkdir -p /data/dsh
# Use the files exactly as they exist in master
RUN cp /app/deepseek-harness/nginx.conf /etc/nginx/nginx.conf && \
cp /app/deepseek-harness/start.sh /start.sh && \
chmod +x /start.sh
EXPOSE 7860
CMD ["/start.sh"]
OR
FROM docker:27-cli
RUN apk add --no-cache git
WORKDIR /src
RUN git clone \
--branch 1.0 \
--depth 1 \
https://github.com/innokria/deepseek-harness.git \
.
CMD ["./start.sh"]
WITH LLAMA CPP and Custom GGUF . RUNNING ON 2 CORE 16GB CPU
DeepSeek Harness + llama.cpp
==========================================================
[DSH] Home: /data
[DSH] Public port: 7860
[DSH] Internal port: 3080
[LLAMA] Server: /app/llama-server
[LLAMA] Host: 127.0.0.1
[LLAMA] Port: 8000
[LLAMA] Model: LFM2.5
[LLAMA] Model path: /app/LFM2.5-VL-3B-Q4_0.gguf
[LLAMA] MMProj path: /app/mmproj-LFM2.5-VL-3B-BF16.gguf
[LLAMA] Context: 22288
[LLAMA] Max tokens: 512
[LLAMA] Threads: 2
<img width="2349" height="1410" alt="image" src="https://github.com/user-attachments/assets/0ee7e6ba-751d-4c09-899c-b8b777b6b90f" />
npx skills add OthmanAdi/planning-with-files --skill planning-with-files -g
dsh plugin --profile web add dsh-planning-with-files
DeepSeek Harness is in developer preview and iterating rapidly. THERE WILL BE COMPATIBILITY-BREAKING CHANGES.
Review the safety notice before running the project.
Install Node.js, then run:
npx @deepseek-ai/dsh webThe 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.
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 webpnpm run build prepares the repository artifacts. pnpm dsh web uses those built artifacts without rebuilding.
- Submit feedback or bug reports through GitHub Discussions.
- Add the
dsh-plugintopic to your plugin repository for discoverability. - Join DeepSeek Harness Discord community.
See CONTRIBUTING.md.
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.
@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}},
}Third-party dependencies and their licenses are disclosed in THIRD_PARTY_NOTICES.md.