Skip to content
DSH Themes
Back to Learn
04Installation7 min readBeginner

BEGINNER GUIDE · FIRST RUN

DeepSeek Harness quick start

Use the official path for a first look, but keep the workspace disposable and the server on loopback. Exploring DSH and authorizing a verified theme are two different operations.

Last verified
Aug 20, 2026
Runtime
0.1.0-rc.8
Verified scope
  • Official npm launch path
  • Official Web UI guide
  • Loopback and workspace safety boundary
On this page
  1. Before starting
  2. Launch the official Web UI
  3. Complete one small, observable task

Before starting

  • Use a supported Node.js environment and a project folder that is safe to inspect.
  • Do not begin in a directory containing secrets or files you are unwilling to change.
  • Keep the Web UI on its default loopback address rather than exposing it to a local network.
  • Have the API credential for the model provider you intend to configure.

Launch the official Web UI

bash
npx @deepseek-ai/dsh@0.1.0-rc.8 web
Exact official rc.8 developer-preview launch command for trying the Web UI. Automated runs should append --no-open.

Complete one small, observable task

  1. 01

    Open the printed loopback address

    The default is a browser UI on port 3080. Use the address printed by the process and keep the terminal running.

  2. 02

    Configure a model

    Open Settings and add the required provider credential. Do not paste credentials into a conversation or project file.

  3. 03

    Choose a disposable workspace

    Add the project directory you launched from, then select it. The composer remains unavailable until a workspace is selected.

  4. 04

    Ask for a read-only first task

    Start by asking the Agent to summarize the repository and identify its main packages. Review what it reads before requesting edits.

  5. 05

    Read every approval prompt

    Check the command, path, and intended effect. Reject an operation that reaches outside the selected workspace or does more than the task requires.

After the first run

Understand the architectureLearn why the model, tools, log, and UI are plugins.Explore visual releasesBrowse without changing the local profile.Install a verified releaseUse the stricter local workflow for an exact artifact.

Common questions

Before you make a change

Answers about formats, compatibility, evidence, and rollback.

What does this guide verify?

This guide covers: Official npm launch path; Official Web UI guide; Loopback and workspace safety boundary

What should I do first?

Use the official path for a first look, but keep the workspace disposable and the server on loopback. Exploring DSH and authorizing a verified theme are two different operations.

Which boundary matters most?

You have connected a model, selected a workspace, sent a user message, observed tool policy, and recorded a session. That is a more useful milestone than immediately installing many plugins.

Continue learning

Previous guideDeepSeek Harness vs Codex vs Claude CodeNext guideChoose a Theme or a Full Skin

Continue from the verified evidence

Compare published artifacts or return to the installation documentation.

ExploreDocs