Download DeepSeek Harness (DSH) Portable

Download the portable pack for your system

• 

  Windows

  Unzip, then double-click start.cmd
  Download · 64-bit

  Windows 10/11 x64. Unzip first, then run start.cmd.

• 

  macOS

  Double-click Start.command
  Download · Apple silicon

  M1/M2/M3/M4, any Mac from late 2020 on

  Download · Intel

  Intel-based Macs made before 2020

• 

  Linux

  bash start.sh
  Download · x86_64

  Intel or AMD processors

  Download · ARM64

  Raspberry Pi, ARM cloud hosts (aarch64)

Troubleshooting

1. 1.

   I unzipped it. Now what?

   On macOS double-click Start.command, on Windows double-click start.cmd, on Linux run bash start.sh in the folder. A terminal window pops up alongside it — that's the running service, so leave it alone. Your browser should open 127.0.0.1:17880 by itself; if it doesn't, type that address in.

2. 2.

   Where do I put my API key?

   In the settings panel of the interface. It lands in a local config file, so you only type it once. No key yet? Create one on the DeepSeek open platform. The key stays on your machine and never reaches us.

3. 3.

   macOS says the developer can't be verified

   Right-click the start script, choose Open, then click Open again in the dialog. That's the routine check for unsigned apps. The script clears the quarantine flag while it runs, so a plain double-click works from then on.

4. 4.

   Windows shows "Windows protected your PC"

   Click More info, then Run anyway. And unzip first: double-clicking start.cmd inside the archive won't start anything.

5. 5.

   The window flashes and disappears

   Make sure you unzipped into a real folder first — don't run start.cmd from the zip preview. Try again: the newer start.cmd stays open on failure and writes start.log. Common causes are antivirus blocking node.exe, or a path with spaces/non-ASCII characters — unzip to a short ASCII path. Paste start.log into the report form above.

6. 6.

   The terminal is open but the browser shows nothing

   Look for 127.0.0.1:17880 in the terminal or start.log. If it's there, open that address by hand; if another program already holds port 17880, close it first. If there's an error, send us the whole thing.

7. 7.

   Linux says permission denied

   Skip chmod and run bash start.sh. On a headless box no browser opens, so visit http://127.0.0.1:17880 yourself.

8. 8.

   How do I fully quit?

   Closing the browser tab only closes the interface; the service keeps running. That terminal window from startup is the service itself, so go back to it and press Ctrl+C, or just close it.

9. 9.

   How do I uninstall?

   Delete the folder and you're done. Nothing goes into the registry, no system service is installed.

10. 10.

    Why is it over 300MB?

    The Node runtime and every dependency ride along, which is why you don't install anything. That size is expected.

11. 11.

    Can I go back to an older build?

    Each pack pins one tested Harness and Node pair. Harness is still a developer preview, so if a build misbehaves, pull an earlier pack from GitHub Releases — every past version is still there.