deepseek-ai/deepseek-harness · error · FileNotFoundError

deepseek-harness-runtime-bin is missing the default runtime

Error message

deepseek-harness-runtime-bin is missing the default runtime config at {path}

What it means

Error "deepseek-harness-runtime-bin is missing the default runtime config at {path}" thrown in deepseek-ai/deepseek-harness.

Source

Thrown at python/sdk-runtime/src/deepseek_harness_runtime/__init__.py:64

def bundled_package_dir() -> Path:
    """Root directory of the installed runtime package data (the directory of this module)."""
    root = Path(__file__).resolve().parent
    metadata = root / PACKAGE_METADATA_FILENAME
    if not metadata.is_file():
        raise FileNotFoundError(f"deepseek-harness-runtime-bin is missing {metadata}")
    return root


def bundled_default_config_path() -> Path:
    """Path of the checked-in default runtime configuration (``runtime/cordis.yml``).

    The client SDK injects this path via ``$DSH_CORDIS_CONFIG`` when the caller
    supplies no config and the launch resolves to the bundled runtime — the
    runtime binary itself always demands an explicit config.
    """
    path = bundled_package_dir() / "runtime" / "cordis.yml"
    if not path.is_file():
        raise FileNotFoundError(
            f"deepseek-harness-runtime-bin is missing the default runtime config at {path}"
        )
    return path


def bundled_runtime_path() -> Path:
    """Absolute path of the bundled single-file runtime executable for the current platform.

    Raises FileNotFoundError when the platform is unsupported, the executable
    has not been placed into this package, the required ripgrep sidecar is
    missing, or the required macOS spawn helper is missing; the message names
    the acquisition routes (acquisition strategy is deliberately separate from
    this lookup interface, so an on-demand download can replace it without
    touching callers).
    """
    tag = _current_platform_tag()
    path = bundled_package_dir() / "runtime" / f"dsh-jsonrpc-agent-pkg-{tag}"
    if not path.is_file():

View on GitHub (pinned to b150a551b8)

Solutions

1. Install the matching deepseek-harness-runtime-bin wheel (or rebuild the exe payload) so the default runtime config exists at the path.

When it happens

Trigger: Thrown at python/sdk-runtime/src/deepseek_harness_runtime/__init__.py:64 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of deepseek-ai/deepseek-harness@b150a551b8 (2026-08-24). Data as JSON: /api/errors/20a2b4bfb5b2d020. Report an issue: GitHub.