02 · 4 entry points

Up and running in 60 seconds

With Node.js installed, one command and it is running in your browser.

  • 4 ways to start it
  • 1 command for the web app
  • 3080 default port
npx @deepseek-ai/dsh web

That brings the interface up at http://127.0.0.1:3080.

Two things are missing when you get there.

  • Missing one An API key Goes in Settings and then in Models
  • Missing two A workspace Picked with the select workspace button. Until you choose one the input box stays locked. That is not a bug: it does not know which folder to work on yet

The directory you launch the command from is the one it suggests by default, so it is worth thinking about before you type.

The other three doors

  • From source If you plan to read or change something Clone, install dependencies, build and run. Building is mandatory before executing.
  • From the command line To automate Headless mode runs one task, prints the answer and exits, which is exactly what you want in continuous integration.
  • From Python To embed it in a program of your own Installed with pip, the runtime is bundled and does not need Node on the system. Works on Linux and recent macOS with an ARM processor, not on Windows.
Technical detail optional

The dsh command is a profile launcher. Its own flags always come first, and the first token it does not recognise marks the start of the application arguments. That is why dsh --profile web --port 8080 works, and dsh --help returns the launcher help while dsh --profile web --help returns the web application help. To see the tree of pieces your machine boots without booting it: dsh --profile web --dump-config.