Metadata-Version: 2.4
Name: ksadk
Version: 0.5.5
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<0.124.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: 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,>=0.3.0
Requires-Dist: langchain-openai<2.0.0,>=0.2.0
Requires-Dist: langchain-core<2.0.0,>=0.3.0
Requires-Dist: langgraph<2.0.0,>=0.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>=1.0.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>=0.3.0; extra == "langchain"
Requires-Dist: langchain-openai>=0.2.0; extra == "langchain"
Requires-Dist: langchain-core>=0.3.0; extra == "langchain"
Provides-Extra: langgraph
Requires-Dist: langgraph>=0.2.0; extra == "langgraph"
Requires-Dist: langchain>=0.3.0; extra == "langgraph"
Requires-Dist: langchain-openai>=0.2.0; extra == "langgraph"
Requires-Dist: protobuf>=6.32.1; extra == "langgraph"
Provides-Extra: deepagents
Requires-Dist: deepagents>=0.3.0; python_version >= "3.11" and extra == "deepagents"
Requires-Dist: langgraph>=0.2.0; extra == "deepagents"
Requires-Dist: langchain>=0.3.0; extra == "deepagents"
Requires-Dist: langchain-openai>=0.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: 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,tracing]; extra == "all"

# ksadk-python

`ksadk-python` 是 `agentengine` / `ksadk` 的 Python 实现仓库，负责本地开发入口、Agent CLI、部分本地运行时能力，以及 Hermes / OpenClaw 共享运行时资产。

当前代码主线版本：`0.5.4`。

## 仓库定位

- 本地开发：`init / config / run / web`
- 构建部署：`build / deploy / launch`
- 远端调用：`agent invoke`、`files`、`dashboard`
- 运行时资产：`deploy/hermes`、`deploy/openclaw`
- 共享源码：`ksadk_runtime_common`

```mermaid
flowchart LR
  classDef client fill:#dbeafe,stroke:#1d4ed8,stroke-width:2px,color:#1e3a8a;
  classDef control fill:#ede9fe,stroke:#7c3aed,stroke-width:2px,color:#581c87;
  classDef data fill:#dcfce7,stroke:#16a34a,stroke-width:2px,color:#166534;
  classDef storage fill:#ffedd5,stroke:#ea580c,stroke-width:2px,color:#9a3412;
  classDef runtime fill:#e2e8f0,stroke:#475569,stroke-width:2px,color:#1e293b;

  CLI["agentengine / ksadk"]:::client --> Repo["ksadk-python"]:::runtime
  Repo --> Local["本地运行时与 Web UI"]:::data
  Repo --> Common["ksadk_runtime_common"]:::runtime
  Repo --> Hermes["Hermes Runtime"]:::data
  Repo --> OpenClaw["OpenClaw Runtime"]:::data
  Repo --> Control["agentengine-server"]:::control
  Hermes --> PVC["PVC / workspace"]:::storage
  OpenClaw --> PVC
  Local --> Workspace[".agentengine/ui/workspace"]:::storage
  Common --> Hermes
  Common --> OpenClaw
  Common --> Local
```

## 快速开始

```bash
pip install -U ksadk

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

云端部署最短路径：

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

## 文档导航

### 主文档

- [ksadk使用文档](./docs/ksadk使用文档.md)
- [ksadk技术设计](./docs/ksadk技术设计.md)
- [工作区文件技术设计](./docs/工作区文件技术设计.md)

### 专题文档

- [记忆使用指南](./docs/记忆使用指南.md)
- [知识库与记忆示例](./docs/知识库与记忆示例.md)
- [OpenClaw一键部署指南](./docs/openclaw一键部署指南.md)
- [DeepAgents说明](./docs/DeepAgents说明.md)
- [Hermes 运行时说明](./deploy/hermes/README.md)
- [OpenClaw 用户镜像模板说明](./deploy/openclaw-user-template/README.md)

### 内部与历史资料

- `docs/archive/`：历史方案稿、阶段性实施说明、版本文档
- `docs/internal/`：内部 runbook、分析稿、协作说明

查看云端面板：

```bash
agentengine dashboard open
# 或显式指定 Agent
agentengine dashboard open --agent ar-xxxx
```

## 说明

- `README` 只保留仓库定位、入口和导航。
- 命令说明、默认值、限制和示例统一收口到 [ksadk使用文档](./docs/ksadk使用文档.md)。
- 设计分层、运行时链路、共享源码和 Docker 集成统一收口到 [ksadk技术设计](./docs/ksadk技术设计.md)。
- Workspace Files 的协议、路径、安全模型和跨 runtime 数据面统一收口到 [工作区文件技术设计](./docs/工作区文件技术设计.md)。
