pybuildkite

What it is and what it does

PyBuildkite is a Python wrapper around the Buildkite API that lets you interact with your CI/CD infrastructure programmatically. It abstracts the HTTP layer and provides object-oriented methods to query organizations, list and create builds, filter by pipeline state, and download build artifacts—either as complete binary data or streamed in chunks to manage memory. The library handles pagination automatically when enabled, returning response objects with navigation properties for large datasets.

You instantiate a Buildkite object, set your API token, and then call methods on resource objects (organizations, builds, artifacts) to perform operations. The per_page parameter lets you tune response sizes for organizations with large datasets that might otherwise timeout. It depends only on requests, so it integrates easily into existing Python projects without heavy dependencies.

Use it for:

• Query organization metadata and pipeline configuration from Buildkite without manual API calls.
• List, filter, and create builds programmatically, such as triggering builds on specific commits or branches.
• Download build artifacts (logs, binaries, test reports) for post-build processing or archival.
• Automate CI/CD workflows by polling build status and reacting to state changes in Python.
• Stream large artifacts to disk in chunks to avoid loading entire files into memory.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

A Python client library for the Buildkite API that lets you query organizations, manage builds, list pipelines, and download artifacts programmatically.

Yes, if you need to automate Buildkite workflows in Python. The package is stable, has low install friction, carries no known vulnerabilities, and is actively maintained despite aging release cadence. The permissive BSD license poses no restriction. Verify that it supports your Python version before relying on it in production.

Install

pybuildkite on PyPI

pip install pybuildkite

uv add pybuildkite

poetry add pybuildkite

Installing pybuildkite

Before you install

Installs cleanly with a single dependency (requests). Maintenance is aging—last release was 379 days ago, though the repository remains active with a recent commit on 2025-09-17.

License in practice

Distributed under the BSD 2-Clause License, a permissive license that allows commercial and private use with minimal restrictions.

Quickstart

pip install pybuildkite

from pybuildkite.buildkite import Buildkite

buildkite = Buildkite()
buildkite.set_access_token('YOUR_API_ACCESS_TOKEN_HERE')
org = buildkite.organizations().get_org('my-org')

Requires a valid Buildkite API access token to authenticate requests.

Verify before relying

• Whether the package supports modern Python versions (requires_python is unspecified in the fact sheet).
• Current test coverage and whether all Buildkite API endpoints are fully wrapped.

Package facts

Evidence: pybuildkite-1.3.0-py3-none-any.whl

Keywords: Buildkite, Continuous Integration, API, CI, wrapper, python

Tags

More Build Tools packages