deepseek-ai/deepseek-harness · error · FileNotFoundError

Unable to locate the bundled DeepSeek Harness SDK runtime. I

Error message

Unable to locate the bundled DeepSeek Harness SDK runtime. Install deepseek-harness-runtime-bin or set HarnessConfig.runtime_bin.

What it means

Error "Unable to locate the bundled DeepSeek Harness SDK runtime. Install deepseek-harness-runtime-bin or set HarnessConfig.runtime_bin." thrown in deepseek-ai/deepseek-harness.

Source

Thrown at python/sdk/src/deepseek_harness/client.py:432

        parts: list[str] = []
        if proc is not None:
            exit_code = proc.poll()
            if exit_code is not None:
                parts.append(f"exit code: {exit_code}")
        if self._stderr_lines:
            parts.append("stderr tail:\n" + "\n".join(self._stderr_lines))
        return "\n".join(parts)

    def _default_launch_args(self) -> tuple[str, ...]:
        if self.config.runtime_bin is not None:
            return (self.config.runtime_bin,)
        if self.config.bridge_bin is not None:
            return (self.config.bridge_bin,)
        try:
            from deepseek_harness_runtime import resolve_bundled_launch_args
        except ImportError as exc:
            raise FileNotFoundError(
                "Unable to locate the bundled DeepSeek Harness SDK runtime. "
                "Install deepseek-harness-runtime-bin or set HarnessConfig.runtime_bin."
            ) from exc
        return resolve_bundled_launch_args()

    def _inject_bundled_default_config(self, env: dict[str, str]) -> None:
        """Inject the default config for a bundled launch with no non-empty config.

        Both bundled carriers require an explicit config. Explicit runtime,
        launch-argument, and config channels remain untouched.
        """
        uses_bundled_runtime = (
            self.config.launch_args_override is None
            and self.config.runtime_bin is None
            and self.config.bridge_bin is None
        )
        if not uses_bundled_runtime or env.get("DSH_CORDIS_CONFIG"):
            return

View on GitHub (pinned to b150a551b8)

Solutions

1. Install deepseek-harness-runtime-bin or set HarnessConfig.runtime_bin to the runtime executable path.

When it happens

Trigger: Thrown at python/sdk/src/deepseek_harness/client.py:432 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/938b3030e014197a. Report an issue: GitHub.