安装 - AgentKit 文档

前置条件

Python 3.10 及以上版本。
火山方舟 API Key，用于调用模型，可在火山引擎方舟控制台创建。

从 PyPI 安装

从 PyPI 安装 VeADK 1.0.5：

pip install "veadk-python==1.0.5"

可选依赖组

VeADK 通过可选依赖组提供按需能力，可根据用途单独安装：

pip install "veadk-python[extensions]"

依赖组	用途
`extensions`	飞书渠道、Cozeloop、LlamaIndex 等集成
`database`	Redis、MySQL、Viking DB、mem0 等存储后端
`eval`	基于 DeepEval 与 Google ADK 的评测
`a2ui`	A2UI
`harness`	Harness 服务与 Headroom 集成
`pdf`	向后兼容的安装别名；1.0.5 已默认安装 PDF 页面渲染依赖

speech 与 cli 依赖组为兼容已有安装命令而保留，在 1.0.5 中不会增加额外依赖。

从源码构建

如需基于源码开发，可使用 uv 构建：

git clone --branch 1.0.5 --depth 1 https://github.com/volcengine/veadk-python.git
cd veadk-python

# 创建 Python 3.12 虚拟环境
uv venv --python 3.12

# 安装依赖（如需可选依赖组，使用 --extra <name> 或 --all-extras）
uv sync --all-extras

# 以可编辑模式安装 VeADK
uv pip install -e .

安装完成后，即可进入快速开始运行第一个智能体。

最后修改于 2026年9月19日