Start from the support matrix
The current official documentation identifies Python 3.10+, Linux x64/arm64, and macOS arm64. It describes a bundled runtime, so the SDK path does not depend on a system Node installation. A specific composition in the documentation does not support Windows agents; that should not be generalized beyond the documented composition without testing.
- Python: 3.10 or newer.
- Platforms documented: Linux x64, Linux arm64, macOS arm64.
- Runtime: bundled for the SDK flow.
- Windows: do not claim support without an official statement or direct test.
Make the first run intentionally small
Use a temporary or disposable workspace, a minimal prompt, and a constrained permission profile. Confirm the process starts, the session emits expected events, and the final result is accessible before adding persistence or broader tools.
python --version
python -m pip --version
python -c "import platform; print(platform.system(), platform.machine())"Persistent sessions change the failure model
Persistence introduces identifiers, storage location, resume behavior, and cleanup. Record whether a failure occurs during agent startup, model invocation, tool use, event streaming, or session resume instead of collapsing every problem into “the SDK failed.”
Example compositions are not security defaults
An example using danger-full-access and a non-interactive approval policy demonstrates capability, not a recommended baseline. Start with the narrowest workspace and permission shape that completes the intended SDK task.
Platform runs still required
HarnessBase will run the minimal example and a persistent-session example in accessible supported environments, record package and runtime versions, and retain failures before indexing this page.
Sources and evidence boundary
Primary sources establish product facts. HarnessBase labels direct testing separately and does not convert community observations into verified results.
- Official DeepSeek Harness repository ↗ — Python SDK package, examples, and platform documentation.
Target query cluster: DeepSeek Harness Python SDK · DeepSeek Harness Python · pip DeepSeek Harness