CodeBuddy Agent SDK for Python

SDK for building AI agents with CodeBuddy Code's capabilities. Programmatically interact with AI to build autonomous agents that can understand codebases, edit files, and execute workflows.

Installation

# Using uv (recommended)
uv add codebuddy-agent-sdk

# Using pip
pip install codebuddy-agent-sdk

Quick Start

import asyncio
from codebuddy_agent_sdk import query

async def main():
    async for message in query(
        prompt="What files are in this directory?",
        permission_mode="bypassPermissions",
    ):
        if message.type == "assistant":
            for block in message.content:
                if hasattr(block, "text"):
                    print(block.text)

asyncio.run(main())

API Reference

`query(prompt, **options)`

Create a query to interact with the agent.

async for message in query(
    prompt="Your prompt here",
    model="sonnet",                    # Model to use
    permission_mode="bypassPermissions",  # Permission mode
    max_turns=10,                      # Maximum conversation turns
    cwd="/path/to/project",            # Working directory
):
    # Handle message
    pass

Message Types

system - Session initialization info
assistant - Agent responses (text, tool calls)
result - Query completion status
task_started / task_notification - Background task lifecycle events (TaskStartedMessage / TaskNotificationMessage, both subclasses of SystemMessage). Emitted when a tool runs a command with run_in_background: true. Concurrent tasks are told apart by task_id.

Background tasks

Background task completion can arrive after the first ResultMessage, so use CodeBuddySDKClient with receive_messages() (which keeps reading) rather than query() / receive_response() (which stop at the first result):

from codebuddy_agent_sdk import (
    CodeBuddySDKClient,
    CodeBuddyAgentOptions,
    TaskStartedMessage,
    TaskNotificationMessage,
)

async def main():
    options = CodeBuddyAgentOptions(permission_mode="bypassPermissions")
    async with CodeBuddySDKClient(options=options) as client:
        await client.query("Run a background command and report when it finishes")
        async for msg in client.receive_messages():
            if isinstance(msg, TaskStartedMessage):
                print("started", msg.task_id, msg.description)
            elif isinstance(msg, TaskNotificationMessage):
                print("done", msg.task_id, msg.status, msg.output_file)

Feedback

Submit issues at Issues
Contact: codebuddy@tencent.com

Development Status
- 3 - Alpha
Intended Audience
- Developers
Programming Language
Typing
- Typed

Metadata

Development Status
- 3 - Alpha
Intended Audience
- Developers
Programming Language
Typing
- Typed

Release files for codebuddy-agent-sdk 0.3.281.dev202610201531

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distributions (wheels)

Table of built distributions (wheels) for codebuddy-agent-sdk 0.3.281.dev202610201531
File	Interpreter	ABI	Platform	Reset
codebuddy_agent_sdk-0.3.281.dev202610201531-py3-none-win_amd64.whl 62.7 MB Oct 20, 2026 Without provenance	Python 3	none	Windows x86-64	Details
codebuddy_agent_sdk-0.3.281.dev202610201531-py3-none-musllinux_1_1_x86_64.whl 55.7 MB Oct 20, 2026 Without provenance	Python 3	none	Linux musl 1.1+ x86-64	Details
codebuddy_agent_sdk-0.3.281.dev202610201531-py3-none-musllinux_1_1_aarch64.whl 55.2 MB Oct 20, 2026 Without provenance	Python 3	none	Linux musl 1.1+ ARM64	Details
codebuddy_agent_sdk-0.3.281.dev202610201531-py3-none-manylinux_2_17_x86_64.whl 59.1 MB Oct 20, 2026 Without provenance	Python 3	none	Linux glibc 2.17+ x86-64	Details
codebuddy_agent_sdk-0.3.281.dev202610201531-py3-none-manylinux_2_17_aarch64.whl 58.8 MB Oct 20, 2026 Without provenance	Python 3	none	Linux glibc 2.17+ ARM64	Details
codebuddy_agent_sdk-0.3.281.dev202610201531-py3-none-macosx_11_0_arm64.whl 49.0 MB Oct 20, 2026 Without provenance	Python 3	none	macOS 11.0+ ARM64	Details
codebuddy_agent_sdk-0.3.281.dev202610201531-py3-none-macosx_10_12_x86_64.whl 51.3 MB Oct 20, 2026 Without provenance	Python 3	none	macOS 10.12+ x86-64	Details

Total release size: 391.9 MB

Release files / codebuddy_agent_sdk-0.3.281.dev202610201531-py3-none-win_amd64.whl

Download URL	codebuddy_agent_sdk-0.3.281.dev202610201531-py3-none-win_amd64.whl
Size	62.7 MB
Tags	Python 3 Windows x86-64
SHA-256 checksum How to use checksums	`ef1417d6b65fb679a0680f89bf62f678c24d8bf830ec0c9e34fec1569a878b89`
BLAKE2b-256 checksum How to use checksums	`2db242edb3c7961fe567a4a7895aeea635394a11aa77ed10cee2310892ad0211`
Upload date	Oct 20, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.9 {"installer":{"name":"uv","version":"0.12.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"12","id":"bookworm","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / codebuddy_agent_sdk-0.3.281.dev202610201531-py3-none-musllinux_1_1_x86_64.whl

Download URL	codebuddy_agent_sdk-0.3.281.dev202610201531-py3-none-musllinux_1_1_x86_64.whl
Size	55.7 MB
Tags	Linux musl 1.1+ x86-64 Python 3
SHA-256 checksum How to use checksums	`da0734eb76a4ab89a87e8afe22dca8177a9d9cd0e90c9c6de2cc4fceff9966a6`
BLAKE2b-256 checksum How to use checksums	`9a40bad6cddbe0a3d948ea7eb90e9bf6924cac323dd56dd625d55e4d3865790a`
Upload date	Oct 20, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.9 {"installer":{"name":"uv","version":"0.12.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"12","id":"bookworm","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / codebuddy_agent_sdk-0.3.281.dev202610201531-py3-none-musllinux_1_1_aarch64.whl

Download URL	codebuddy_agent_sdk-0.3.281.dev202610201531-py3-none-musllinux_1_1_aarch64.whl
Size	55.2 MB
Tags	Linux musl 1.1+ ARM64 Python 3
SHA-256 checksum How to use checksums	`eeee1145bf2cadf28a0bd8d190db685cc63593732aea7369c28882d111b28aa8`
BLAKE2b-256 checksum How to use checksums	`c6221cded78b503aae70144d5e6d991c5d210bd1b8ad4d5a56a858bee9320364`
Upload date	Oct 20, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.9 {"installer":{"name":"uv","version":"0.12.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"12","id":"bookworm","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / codebuddy_agent_sdk-0.3.281.dev202610201531-py3-none-manylinux_2_17_x86_64.whl

Download URL	codebuddy_agent_sdk-0.3.281.dev202610201531-py3-none-manylinux_2_17_x86_64.whl
Size	59.1 MB
Tags	Linux glibc 2.17+ x86-64 Python 3
SHA-256 checksum How to use checksums	`424e84892d6db545d00d67ae4b476e463e6e2ebb15781ece9168f881e49e3331`
BLAKE2b-256 checksum How to use checksums	`a7d0e412b2cc93a4fd567a7aa5b6d9ab408cbfb37da5498fd0a29cfd15e199c5`
Upload date	Oct 20, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.9 {"installer":{"name":"uv","version":"0.12.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"12","id":"bookworm","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / codebuddy_agent_sdk-0.3.281.dev202610201531-py3-none-manylinux_2_17_aarch64.whl

Download URL	codebuddy_agent_sdk-0.3.281.dev202610201531-py3-none-manylinux_2_17_aarch64.whl
Size	58.8 MB
Tags	Linux glibc 2.17+ ARM64 Python 3
SHA-256 checksum How to use checksums	`6cbc84ba14c4628c40037452cc9ea541eecb8475b512c74b50eb7627653ba0bb`
BLAKE2b-256 checksum How to use checksums	`7433c8256af94cfb7fe584e15ecd21aaf45a7c3ff89677ee3ed5e71cb33a02cf`
Upload date	Oct 20, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.9 {"installer":{"name":"uv","version":"0.12.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"12","id":"bookworm","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / codebuddy_agent_sdk-0.3.281.dev202610201531-py3-none-macosx_11_0_arm64.whl

Download URL	codebuddy_agent_sdk-0.3.281.dev202610201531-py3-none-macosx_11_0_arm64.whl
Size	49.0 MB
Tags	Python 3 macOS 11.0+ ARM64
SHA-256 checksum How to use checksums	`067626783208ca171dea4d0406f6f05a0ff7393b1c357e5094a134779f257cca`
BLAKE2b-256 checksum How to use checksums	`35f520ff5411b1685c4e2385ac4ea75d0e3ba20b92fddc52d7a80cef1b322776`
Upload date	Oct 20, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.9 {"installer":{"name":"uv","version":"0.12.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"12","id":"bookworm","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / codebuddy_agent_sdk-0.3.281.dev202610201531-py3-none-macosx_10_12_x86_64.whl

Download URL	codebuddy_agent_sdk-0.3.281.dev202610201531-py3-none-macosx_10_12_x86_64.whl
Size	51.3 MB
Tags	Python 3 macOS 10.12+ x86-64
SHA-256 checksum How to use checksums	`7caedb3dcdf833e1b041689ea41e9fdc5a065eded388588aa85d3e34d8374797`
BLAKE2b-256 checksum How to use checksums	`12297366a2962a41ab2463b0c93b01d6a7d911faeccbd19b9d306ba6df5eea93`
Upload date	Oct 20, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.9 {"installer":{"name":"uv","version":"0.12.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"12","id":"bookworm","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Security for codebuddy-agent-sdk 0.3.281.dev202610201531

Report project as malware

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.