An open-source kit for agent development, integrated the powerful capabilities of Volcengine.

We use uv to build this project (how-to-install-uv).

git clone ... # clone repo first

cd veadk-python

uv venv --python 3.10

# only install necessary requirements
uv sync

# or, install extra requirements
# uv sync --extra database
# uv sync --extra eval
# uv sync --extra cli

# or, directly install all requirements
# uv sync --all-extras

# install veadk-python with editable mode
uv pip install -e .

We recommand you to create a config.yaml file in the root directory of your own project, VeADK is able to read it automatically.

You can refer to the example config file for more details.

Enjoy a minimal agent from VeADK:

from veadk import Agent
import asyncio

agent = Agent()

res = asyncio.run(agent.run("hello!"))
print(res)

VeADK provides several useful command line tools for faster deployment and optimization, such as:

• veadk deploy: deploy your project to Volcengine VeFaaS platform
• veadk prompt: otpimize the system prompt of your agent by PromptPilot

Before making your contribution to our repository, please install and config the pre-commit linter first.

pip install pre-commit
pre-commit install

Before commit or push your changes, please make sure the unittests are passed ,otherwise your PR will be rejected by CI/CD workflow. Running the unittests by:

pytest -n 16

This project is licensed under the Apache 2.0 License.