Metadata-Version: 2.4
Name: ksadk
Version: 0.5.8
Summary: Kingsoft Cloud Agent Development Kit - 支持 LangChain/LangGraph/DeepAgents/ADK/OpenClaw/Hermes 的本地运行与云端部署
Author-email: KsADK Team <xiayu@kingsoft.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/kingsoftcloud/ksadk-python
Project-URL: Repository, https://github.com/kingsoftcloud/ksadk-python
Project-URL: Documentation, https://ksadk.kingsoft.com/docs
Keywords: agent,langchain,langgraph,deepagents,adk,faas,kingsoft cloud,ai,llm
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: click>=8.0.0
Requires-Dist: pyyaml>=6.0.0
Requires-Dist: packaging>=23.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: pydantic<3.0.0,>=2.0.0
Requires-Dist: jsonschema<5.0.0,>=4.0.0
Requires-Dist: questionary>=2.0.0
Requires-Dist: textual>=0.50.0
Requires-Dist: fastapi<1.0.0,>=0.100.0
Requires-Dist: uvicorn>=0.23.0
Requires-Dist: python-multipart<1.0.0,>=0.0.9
Requires-Dist: python-socks<3.0.0,>=2.7.1
Requires-Dist: httpx>=0.24.0
Requires-Dist: a2a-sdk>=0.3.22
Requires-Dist: httpx-sse>=0.4.0
Requires-Dist: sse-starlette>=2.1.0
Requires-Dist: requests>=2.28.0
Requires-Dist: requests-aws4auth>=1.2.0
Requires-Dist: cryptography>=44.0.0
Requires-Dist: websockets<16.0,>=12.0
Requires-Dist: qrcode>=7.4.0
Requires-Dist: asyncpg<1.0.0,>=0.30.0
Requires-Dist: greenlet>=1.0.0
Requires-Dist: ks3sdk>=1.15.0
Requires-Dist: pypdf>=6.0.0
Requires-Dist: beautifulsoup4>=4.12.0
Requires-Dist: rapidocr-onnxruntime>=1.2.0
Requires-Dist: langchain<2.0.0,>=1.3.0
Requires-Dist: langchain-openai<2.0.0,>=1.2.0
Requires-Dist: langchain-core<2.0.0,>=1.4.0
Requires-Dist: langgraph<1.3.0,>=1.2.0
Requires-Dist: opentelemetry-api==1.37.0
Requires-Dist: opentelemetry-sdk==1.37.0
Requires-Dist: opentelemetry-exporter-otlp==1.37.0
Provides-Extra: adk
Requires-Dist: google-adk<2.0.0,>=1.34.0; extra == "adk"
Requires-Dist: litellm>=1.0.0; extra == "adk"
Requires-Dist: json_repair>=0.25.0; extra == "adk"
Provides-Extra: langchain
Requires-Dist: langchain<2.0.0,>=1.3.0; extra == "langchain"
Requires-Dist: langchain-openai<2.0.0,>=1.2.0; extra == "langchain"
Requires-Dist: langchain-core<2.0.0,>=1.4.0; extra == "langchain"
Provides-Extra: langgraph
Requires-Dist: langgraph<1.3.0,>=1.2.0; extra == "langgraph"
Requires-Dist: langchain<2.0.0,>=1.3.0; extra == "langgraph"
Requires-Dist: langchain-openai<2.0.0,>=1.2.0; extra == "langgraph"
Requires-Dist: protobuf>=6.32.1; extra == "langgraph"
Provides-Extra: deepagents
Requires-Dist: deepagents<1.0.0,>=0.6.2; python_version >= "3.11" and extra == "deepagents"
Requires-Dist: langgraph<1.3.0,>=1.2.0; extra == "deepagents"
Requires-Dist: langchain<2.0.0,>=1.3.0; extra == "deepagents"
Requires-Dist: langchain-openai<2.0.0,>=1.2.0; extra == "deepagents"
Provides-Extra: a2a
Requires-Dist: a2a-sdk[http-server]>=0.3.22; extra == "a2a"
Provides-Extra: tracing
Requires-Dist: openinference-instrumentation-langchain>=0.1.0; extra == "tracing"
Provides-Extra: kb
Requires-Dist: kingsoftcloud-sdk-python>=1.5.8.71; extra == "kb"
Provides-Extra: skills
Requires-Dist: e2b>=2.0.0; extra == "skills"
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
Requires-Dist: black>=22.0.0; extra == "dev"
Requires-Dist: ruff>=0.1.0; extra == "dev"
Requires-Dist: mypy>=1.0.0; extra == "dev"
Provides-Extra: all
Requires-Dist: ksadk[a2a,adk,deepagents,dev,kb,langchain,langgraph,skills,tracing]; extra == "all"

# ksadk

Kingsoft Cloud Agent Development Kit. `ksadk` provides the Python SDK and CLI for building, running, packaging, and deploying AgentEngine agents across local development, serverless runtime, ADK, LangChain/LangGraph, DeepAgents, Hermes, OpenClaw, MCP, and Skill Runtime scenarios.

Current version: `0.5.8`.

## Install

```bash
pip install -U ksadk
```

Install optional runtime extras when needed:

```bash
pip install -U "ksadk[adk]"
pip install -U "ksadk[langgraph]"
pip install -U "ksadk[deepagents]"
pip install -U "ksadk[skills]"
pip install -U "ksadk[all]"
```

## Quick Start

Create and run a local agent:

```bash
agentengine init my-agent -f langgraph
cd my-agent
agentengine config
agentengine run -i
```

Deploy to AgentEngine serverless runtime:

```bash
agentengine launch . --target serverless
```

Open the hosted dashboard:

```bash
agentengine dashboard open
```

## What Is Included

- Local development commands: `init`, `config`, `run`, `web`
- Build and deploy commands: `build`, `deploy`, `launch`
- Remote operations: `agent invoke`, `files`, `dashboard`
- Runtime integrations: ADK, LangChain, LangGraph, DeepAgents, MCP
- Hosted runtime assets: Hermes and OpenClaw
- Skill Runtime preview: Skill Center discovery, zip download, `sha256` verification, safe extraction, local execution, and sandbox execution through the `ksadk[skills]` extra
- Sandbox Runtime preview: common sandbox abstraction with an E2B-compatible backend

## 0.5.8 Highlights

- Hosted UI architecture refactor with API facade, run engine, stream protocol, capability plugins, hooks, and stores.
- Workspace preview improvements for generated files, HTML relative resources, artifacts, and zip export.
- Hermes / OpenClaw hosted terminal stability improvements, including WebSocket keepalive and Windows raw terminal handling.
- Default runtimes updated to Hermes `2026.5.16-ksadk-v1` and OpenClaw `2026.5.20`.

## Documentation

PyPI does not serve repository-relative files such as `./docs/*.md`. The links below use absolute URLs so they render correctly on both PyPI and GitHub.

- [Usage Guide](https://github.com/kingsoftcloud/ksadk-python/blob/master/docs/ksadk%E4%BD%BF%E7%94%A8%E6%96%87%E6%A1%A3.md)
- [Technical Design](https://github.com/kingsoftcloud/ksadk-python/blob/master/docs/ksadk%E6%8A%80%E6%9C%AF%E8%AE%BE%E8%AE%A1.md)
- [Workspace Files Design](https://github.com/kingsoftcloud/ksadk-python/blob/master/docs/%E5%B7%A5%E4%BD%9C%E5%8C%BA%E6%96%87%E4%BB%B6%E6%8A%80%E6%9C%AF%E8%AE%BE%E8%AE%A1.md)
- [Memory Guide](https://github.com/kingsoftcloud/ksadk-python/blob/master/docs/%E8%AE%B0%E5%BF%86%E4%BD%BF%E7%94%A8%E6%8C%87%E5%8D%97.md)
- [Knowledge Base and Memory Examples](https://github.com/kingsoftcloud/ksadk-python/blob/master/docs/%E7%9F%A5%E8%AF%86%E5%BA%93%E4%B8%8E%E8%AE%B0%E5%BF%86%E7%A4%BA%E4%BE%8B.md)
- [DeepAgents Guide](https://github.com/kingsoftcloud/ksadk-python/blob/master/docs/DeepAgents%E8%AF%B4%E6%98%8E.md)
- [Hermes Runtime Guide](https://github.com/kingsoftcloud/ksadk-python/blob/master/deploy/hermes/README.md)
- [OpenClaw Deployment Guide](https://github.com/kingsoftcloud/ksadk-python/blob/master/docs/openclaw%E4%B8%80%E9%94%AE%E9%83%A8%E7%BD%B2%E6%8C%87%E5%8D%97.md)
- [OpenClaw User Image Template](https://github.com/kingsoftcloud/ksadk-python/blob/master/deploy/openclaw-user-template/README.md)
- [Skill Runtime Image Contract](https://github.com/kingsoftcloud/ksadk-python/blob/master/deploy/skill-runtime/README.md)

## Project Links

- Documentation: <https://ksadk.kingsoft.com/docs>
- Repository: <https://github.com/kingsoftcloud/ksadk-python>

## Notes

- Skill registration, CRUD, and version governance belong to Skill Service. `ksadk` consumes Skill Center at runtime.
- Sandbox template and instance lifecycle belong to Sandbox Service. `ksadk` uses the configured sandbox backend to execute runtime workflows.
- E2B-compatible sandbox backend uses the native `E2B_API_URL` and `E2B_API_KEY` environment variables.
