---
id: pybuildkite
version: "1.3.0"
license: BSD 2-Clause License Copyright (c) 2019, Peter Yasi All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following… (full text in the JSON record)
license_treatment: permissive
maintenance: aging
---

# pybuildkite — Python wrapper for the Buildkite API

License: permissive · Maintenance: aging · Downloads: 546.7K/mo

## 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 above — 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

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

- License: BSD 2-Clause License Copyright (c) 2019, Peter Yasi All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following… (full text in the JSON record) (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: aging
- Downloads: 546.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

buildkite api client, ci cd automation python, buildkite builds management, continuous integration api wrapper, buildkite artifacts download, pipeline automation python, buildkite organizations query, ci-cd, api-wrapper, buildkite

[View on SkillFed](https://skillfed.io/packages/pybuildkite) · [View on PyPI](https://pypi.org/project/pybuildkite/)