{"id":35273165,"url":"https://github.com/volcengine/veadk-python","last_synced_at":"2026-05-20T12:14:29.420Z","repository":{"id":307961900,"uuid":"1030578206","full_name":"volcengine/veadk-python","owner":"volcengine","description":"An open-source kit for agent development, integrated the powerful capabilities of Volcengine.","archived":false,"fork":false,"pushed_at":"2026-02-03T13:50:42.000Z","size":68316,"stargazers_count":263,"open_issues_count":8,"forks_count":47,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-02-03T16:36:33.487Z","etag":null,"topics":["agent","sdk","volcengine"],"latest_commit_sha":null,"homepage":"https://volcengine.github.io/veadk-python/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/volcengine.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-01T22:21:20.000Z","updated_at":"2026-02-03T13:53:19.000Z","dependencies_parsed_at":"2025-09-02T07:08:57.503Z","dependency_job_id":"217b11ff-7586-4a3f-8a56-122c271163d3","html_url":"https://github.com/volcengine/veadk-python","commit_stats":null,"previous_names":["volcengine/veadk-python"],"tags_count":55,"template":false,"template_full_name":null,"purl":"pkg:github/volcengine/veadk-python","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/volcengine%2Fveadk-python","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/volcengine%2Fveadk-python/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/volcengine%2Fveadk-python/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/volcengine%2Fveadk-python/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/volcengine","download_url":"https://codeload.github.com/volcengine/veadk-python/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/volcengine%2Fveadk-python/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29328063,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-11T06:13:03.264Z","status":"ssl_error","status_checked_at":"2026-02-11T06:12:55.843Z","response_time":97,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","sdk","volcengine"],"created_at":"2025-12-30T13:02:20.918Z","updated_at":"2026-02-11T06:14:56.435Z","avatar_url":"https://github.com/volcengine.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n    \u003cimg src=\"assets/images/logo.png\" alt=\"Volcengine Agent Development Kit Logo\" width=\"50%\"\u003e\n\u003c/p\u003e\n\n# Volcengine Agent Development Kit\n\n[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)\n[![Deepwiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/volcengine/veadk-python)\n\nAn open-source kit for agent development, integrated the powerful capabilities of Volcengine.\n\nFor more details, see our [documents](https://volcengine.github.io/veadk-python/).\n\nA [tutorial](https://github.com/volcengine/veadk-python/blob/main/veadk_tutorial.ipynb) is available by Jupyter Notebook, or open it in [Google Colab](https://colab.research.google.com/github/volcengine/veadk-python/blob/main/veadk_tutorial.ipynb) directly.\n\n## Installation\n\n### From PyPI\n\n```python\npip install veadk-python\n\n# install extensions\npip install veadk-python[extensions]\n```\n\n### Build from source\n\nWe use `uv` to build this project ([how-to-install-uv](https://docs.astral.sh/uv/getting-started/installation/)).\n\n```bash\ngit clone ... # clone repo first\n\ncd veadk-python\n\n# create a virtual environment with python 3.12\nuv venv --python 3.12\n\n# only install necessary requirements\nuv sync\n\n# or, install extra requirements\n# uv sync --extra database\n# uv sync --extra eval\n# uv sync --extra cli\n\n# or, directly install all requirements\n# uv sync --all-extras\n\n# install veadk-python with editable mode\nuv pip install -e .\n```\n\n## Configuration\n\nWe recommand you to create a `config.yaml` file in the root directory of your own project, `VeADK` is able to read it automatically. For running a minimal agent, you just need to set the following configs in your `config.yaml` file:\n\n```yaml\nmodel:\n  agent:\n    provider: openai\n    name: doubao-seed-1-6-250615\n    api_base: https://ark.cn-beijing.volces.com/api/v3/\n    api_key: # \u003c-- set your Volcengine ARK api key here\n```\n\nYou can refer to the [config instructions](https://volcengine.github.io/veadk-python/configuration/) for more details.\n\n## Have a try\n\nEnjoy a minimal agent from VeADK:\n\n```python\nfrom veadk import Agent\nimport asyncio\n\nagent = Agent()\n\nres = asyncio.run(agent.run(\"hello!\"))\nprint(res)\n```\n\n## Command line tools\n\nVeADK provides several useful command line tools for faster deployment and optimization, such as:\n\n- `veadk deploy`: deploy your project to [Volcengine VeFaaS platform](https://www.volcengine.com/product/vefaas) (you can use `veadk init` to init a demo project first)\n- `veadk prompt`: otpimize the system prompt of your agent by [PromptPilot](https://promptpilot.volcengine.com)\n\n## Contribution\n\nBefore making your contribution to our repository, please install and config the `pre-commit` linter first.\n\n```bash\npip install pre-commit\npre-commit install\n```\n\nBefore 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:\n\n```bash\npytest -n 16\n```\n\n## Contact with us\n\nJoin our discussion group by scanning the QR code below:\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"assets/images/veadk_group_qrcode.jpg\" alt=\"Volcengine Agent Development Kit Logo\" width=\"40%\"\u003e\n\u003c/p\u003e\n\n## License\n\nThis project is licensed under the [Apache 2.0 License](./LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvolcengine%2Fveadk-python","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvolcengine%2Fveadk-python","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvolcengine%2Fveadk-python/lists"}