Getting Started
DSH Nix

Getting Started

Run DeepSeek Harness from the remote flake, choose an output, and configure Cachix.

Quickstart

Try the TUI preset:

nix run github:moraxyc/deepseek-harness.nix#presets.tui \
  --accept-flake-config

The --accept-flake-config flag lets Nix use the repository’s configured binary cache when needed.

Use the Remote Flake

Run or build individual outputs directly from GitHub:

nix run github:moraxyc/deepseek-harness.nix#default -- --version
nix build github:moraxyc/deepseek-harness.nix#dsh
nix build github:moraxyc/deepseek-harness.nix#dsh-desktop
nix build github:moraxyc/deepseek-harness.nix#dsh-kernel
nix build github:moraxyc/deepseek-harness.nix#dsh-workspace
nix build github:moraxyc/deepseek-harness.nix#bundles.tui
nix run github:moraxyc/deepseek-harness.nix#presets.tui

The main outputs are:

OutputPurpose
dshCLI package
dsh-desktopDesktop application
dsh-kernelKernel without profile bundles
dsh-workspaceBuilt workspace artifacts
bundles.*Plugin-style extensions
presets.*Ready-to-use bundle combinations

See the Bundles and Presets catalog for the complete list.

Add It to Another Flake

Declare the repository as an input, then use inputs.deepseek-harness.* for its packages, modules, and overlay:

{
  inputs.deepseek-harness.url = "github:moraxyc/deepseek-harness.nix";
}

With the input declared, continue with the NixOS integration, Home Manager integration, or Advanced Usage guide.

Cachix

Use the public cache with:

cachix use deepseek-harness-nix

Or add it to Nix configuration manually:

{
  nix.settings = {
    substituters = [ "https://deepseek-harness-nix.cachix.org" ];
    trusted-public-keys = [
      "deepseek-harness-nix.cachix.org-1:5NrkwLN9veNMhiINtU5ZeV4isXFhFsOwn6Ms7J1M+TA="
    ];
  };
}

License and Brand Notice

This repository’s own code and documentation are licensed under the MIT License. The license does not cover upstream deepseek-harness, DeepSeek or @deepseek-ai materials, names, or trademarks, or third-party components.

DSH Nix is an independent community project. It is not affiliated with, sponsored by, authorized by, or endorsed by DeepSeek. “DeepSeek Harness” is used only to accurately describe the Nix packaging and integration provided by this project.

DSH Nix uses an independent project name and visual presentation. Its use of brand names and assets follows the upstream DeepSeek Harness Brand Asset Usage Guidelines. See the repository LICENSE for license terms.