python/README.md

# DeepSeek Harness Python SDK

English | [中文](README.zh.md)

Python packages for driving DeepSeek Harness as a subprocess. The client SDK communicates with the bundled runtime over newline-delimited JSON-RPC on stdio.

## Packages

| Directory | Dist / module | Role |
|---|---|---|
| [sdk](sdk/README.md) | `deepseek-harness` / `deepseek_harness` | High-level turns API and lower-level JSON-RPC client |
| [sdk-runtime](sdk-runtime/README.md) | `deepseek-harness-runtime-bin` / `deepseek_harness_runtime` | Bundled runtime binaries and default agent configuration |

## Behavior

The SDK starts the matching bundled runtime unless the caller selects an explicit channel. The client owns channel selection and default-configuration injection; the runtime itself always requires an explicit configuration. The [SDK reference](sdk/README.md) and [runtime carrier reference](sdk-runtime/README.md) own the complete resolution and configuration contracts.

## Contributor workflows

The [Python contributor workflows](development.md) cover building runtime artifacts, validating the packages, source-mode development, and distribution.
python: deepseek-harness SDK and runtime carrier packages 2026-07-11 14:08:24 +08:00			`# DeepSeek Harness Python SDK`

			`English \| [中文](README.zh.md)`

docs: apply hierarchy across the corpus 2026-08-04 00:54:19 +08:00			`Python packages for driving DeepSeek Harness as a subprocess. The client SDK communicates with the bundled runtime over newline-delimited JSON-RPC on stdio.`
python: deepseek-harness SDK and runtime carrier packages 2026-07-11 14:08:24 +08:00
			`## Packages`

			`\| Directory \| Dist / module \| Role \|`
			`\|---\|---\|---\|`
docs: apply hierarchy across the corpus 2026-08-04 00:54:19 +08:00			\| [sdk](sdk/README.md) \| `deepseek-harness` / `deepseek_harness` \| High-level turns API and lower-level JSON-RPC client \|
			\| [sdk-runtime](sdk-runtime/README.md) \| `deepseek-harness-runtime-bin` / `deepseek_harness_runtime` \| Bundled runtime binaries and default agent configuration \|
python: deepseek-harness SDK and runtime carrier packages 2026-07-11 14:08:24 +08:00
docs: apply hierarchy across the corpus 2026-08-04 00:54:19 +08:00			`## Behavior`
python: deepseek-harness SDK and runtime carrier packages 2026-07-11 14:08:24 +08:00
docs: apply hierarchy across the corpus 2026-08-04 00:54:19 +08:00			`The SDK starts the matching bundled runtime unless the caller selects an explicit channel. The client owns channel selection and default-configuration injection; the runtime itself always requires an explicit configuration. The [SDK reference](sdk/README.md) and [runtime carrier reference](sdk-runtime/README.md) own the complete resolution and configuration contracts.`
python: deepseek-harness SDK and runtime carrier packages 2026-07-11 14:08:24 +08:00
docs: apply hierarchy across the corpus 2026-08-04 00:54:19 +08:00			`## Contributor workflows`
python: deepseek-harness SDK and runtime carrier packages 2026-07-11 14:08:24 +08:00
docs: rescan rebased documentation hierarchy 2026-08-05 12:46:38 +08:00			`The [Python contributor workflows](development.md) cover building runtime artifacts, validating the packages, source-mode development, and distribution.`