---
id: antsibull-core
version: "3.6.0"
license: GPL-3.0-or-later AND BSD-2-Clause AND MIT AND PSF-2.0
license_treatment: copyleft
maintenance: active
---

# antsibull-core — Tools for building the Ansible Distribution

License: copyleft · Maintenance: active · Downloads: 159.2K/mo

## What it is and what it does

antsibull-core is a library that provides shared build and tooling infrastructure for the Ansible project and related distribution-building tasks. It handles common patterns needed across Ansible's build scripts—changelog management, versioning, file utilities, and release automation—rather than being a user-facing Ansible feature. The package depends on aiohttp for async HTTP operations, pydantic for data validation, semantic-version for version parsing, and several other utilities for file handling and logging.

The library is actively maintained by the Ansible community and follows semantic versioning from version 1.0.0 onward, with the current development series at 3.x.y. It requires Python 3.9 or later and is typed for static analysis. The package is primarily intended for developers working on Ansible tooling and build infrastructure.

Use it for:

- Building custom Ansible distributions or collections that need standardized versioning and changelog management
- Automating release workflows for Ansible-related projects using the provided build and publishing utilities
- Integrating with Ansible project infrastructure when developing tools that need to interact with Ansible's build system
- Validating and processing Ansible project metadata using pydantic-based data structures

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides core library utilities and tooling infrastructure for building Ansible distributions and related build automation scripts.

Yes, if you are developing Ansible tooling or building Ansible distributions. The package is actively maintained, has low install friction, and provides essential build infrastructure. No, if you are a general Ansible user—this is a developer library for the Ansible project itself, not an Ansible feature or plugin. The copyleft license requires your project to be GPL-compatible.

## Install

pip install antsibull-core
uv add antsibull-core
poetry add antsibull-core

## Installing antsibull-core

Before you install: Low install friction with a pure-Python wheel distribution. Active maintenance with a release 27 days ago. Requires Python 3.9 or later and depends on 9 runtime packages including aiohttp and pydantic.

License in practice: Copyleft license (GPL-3.0-or-later) with mixed licensing in vendored code (BSD-2-Clause, MIT, PSF-2.0). Use is restricted to GPL-compatible projects unless you obtain alternative licensing.

Quickstart:

pip install antsibull-core
import antsibull_core

Requires Python 3.9 or later

Verify before relying:

- Whether the package is intended for end-user consumption or primarily for Ansible project maintainers
- Specific API stability guarantees beyond the semantic versioning statement in the description

## Package facts

- License: GPL-3.0-or-later AND BSD-2-Clause AND MIT AND PSF-2.0 (copyleft)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 159.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

ansible build tools library, ansible distribution packaging, build automation for ansible, ansible tooling infrastructure, ansible project build utilities, ansible changelog and versioning, ansible release automation, ansible-ecosystem, build-infrastructure

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