Metadata-Version: 2.4
Name: ksadk
Version: 0.4.0
Summary: Kingsoft Cloud Agent Development Kit - 支持 LangChain/LangGraph/DeepAgents/ADK 的本地运行与云端部署
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: 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: 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: 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: chainlit>=1.0.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 (AgentEngine CLI)

`ksadk` 是金山云 Agent 开发与部署工具链，统一提供本地调试、构建部署、远端资源管理，以及平台级 KB/LTM、MCP、OpenClaw 接入能力。

当前版本：`0.4.0`

## 安装

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

可选依赖：

```bash
pip install "ksadk[langgraph]"
pip install "ksadk[langchain]"
pip install "ksadk[deepagents]"
pip install "ksadk[adk]"
pip install "ksadk[kb]"
```

命令入口等价：

```bash
agentengine --help
ksadk --help
```

## 最快路径

### 1. 本地运行

```bash
agentengine init my_agent -f langgraph
cd my_agent
agentengine config
agentengine run -i
# 或
agentengine web --port 8080
```

### 2. 一键部署

```bash
export KSYUN_ACCESS_KEY=your-ak
export KSYUN_SECRET_KEY=your-sk
export KSYUN_ACCOUNT_ID=your-account-id
export KSYUN_REGION=cn-beijing-6

agentengine launch . --target serverless
```

### 3. 打开云端 UI

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

## 主文档

- [使用文档](./docs/ksadk_usage_guide.md)
- [技术文档](./docs/ksadk_technical_design.md)

## 专题参考

- [DeepAgents 框架参考](./docs/deepagents.md)
- [KB / LTM 示例参考](./docs/knowledge_base_and_memory_examples.md)
- [ADK 记忆能力专项参考](./docs/memory_usage_guide.md)
- [OpenClaw 一键部署与接入参考](./docs/openclaw_client_one_click_deploy.md)
- [Runner Approval 架构草案](./docs/Runner_Approval_Architecture.md)

## 说明

- `README` 现在只保留入口信息，不再承载完整命令说明。
- 完整 CLI 路径、环境变量、KB/LTM、MCP、OpenClaw、JSON 输出等说明统一收口到 [使用文档](./docs/ksadk_usage_guide.md)。
- 当前实现设计、核心子系统、关键调用链和与 `agentengine-server` 的边界统一收口到 [技术文档](./docs/ksadk_technical_design.md)。
