Development setup

Prepare a local environment and run DeepSeek Harness Desktop from source.

Development requires both the JavaScript frontend toolchain and the Rust/Tauri platform toolchain. The released app does not require these tools.

Prerequisites

• Node.js 20 or later.
• Rust 1.77.2 or later with Cargo.
• Corepack and the repository-pinned pnpm 10.28.2.
• Git and platform-specific Tauri dependencies.

Windows

Install Microsoft C++ Build Tools with the MSVC workload and WebView2.

macOS

Install Xcode Command Line Tools:

xcode-select --install

Ubuntu / Debian

Install WebKit2GTK and Tauri build packages:

sudo apt update
sudo apt install libwebkit2gtk-4.1-dev libappindicator3-dev librsvg2-dev patchelf

Run from source

1. Clone the repository

   git clone https://github.com/dsh-tauri-desk/deepseek-harness-desktop.git
   cd deepseek-harness-desktop
   
2. Activate pinned pnpm

   corepack enable
   corepack install
   
3. Install dependencies

   pnpm install --frozen-lockfile
   
4. Start Tauri development

   pnpm tauri dev
   

The frontend development server runs at http://localhost:1420; the debug Harness service defaults to 127.0.0.1:3081. Debug data is isolated from the release app.

pnpm dev starts only Vite. Use pnpm tauri dev when testing native commands, runtime installation, service lifecycle, windows, or updater behavior.