python-libmaas

What it is and what it does

python-libmaas is a Python client library and command-line tool for interacting with MAAS, a bare-metal infrastructure provisioning platform. It provides both a programmatic API and a CLI interface for managing physical servers, networks, and deployment workflows. The library wraps MAAS REST APIs and handles authentication via OAuth and Macaroon tokens, making it suitable for infrastructure automation and systems administration tasks.

The package depends on aiohttp for async HTTP, PyYAML for configuration, oauthlib for OAuth flows, macaroonbakery for token handling, and several UI/display libraries including colorclass, terminaltables, and argcomplete. It targets Python 3.6–3.9 and is classified as Alpha-stage software. The last release was in August 2022, and while the repository remains active, the lack of recent commits suggests limited active maintenance.

Use it for:

• Automate bare-metal server provisioning and deprovisioning workflows in MAAS-managed environments.
• Build infrastructure-as-code scripts that configure networks, storage, and power management for physical hardware.
• Integrate MAAS into CI/CD pipelines to dynamically allocate and release test machines.
• Query and monitor MAAS inventory, including machine status, resource allocation, and deployment history.
• Manage user credentials and OAuth authentication for multi-tenant MAAS environments programmatically.

Worth the install?

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

Python client library and CLI for MAAS, providing programmatic and command-line access to bare-metal infrastructure provisioning and management.

Yes, if you are actively using MAAS and need programmatic control or CLI access to its APIs. The low install friction and absence of known vulnerabilities make it safe to deploy. However, the aging maintenance status (last release August 2022, no commits since) means you should verify that the library remains compatible with your MAAS version and modern dependency versions before relying on it for new projects. Not suitable if you cannot accept AGPLv3 licensing.

Install

python-libmaas on PyPI

pip install python-libmaas

uv add python-libmaas

poetry add python-libmaas

Installing python-libmaas

Before you install

Low install friction with a pure-Python wheel distribution. Maintenance is aging—last release was in August 2022 and no commits since September 2025, though the repository remains active. Nine runtime dependencies are all established packages.

License in practice

Licensed under AGPLv3, a copyleft license requiring that any derivative work or distribution also be licensed under AGPLv3. This is suitable for internal tools and open-source projects but incompatible with proprietary software that cannot be released under the same terms.

Quickstart

pip install python-libmaas

from aiohttp import ClientSession
import asyncio

async def example():
    async with ClientSession() as session:
        # Use python-libmaas with aiohttp for MAAS API calls
        pass

asyncio.run(example())

Requires a running MAAS instance with valid credentials; async/await context requires Python 3.5+.

Verify before relying

• Whether the package works with Python versions beyond 3.9 despite the description mentioning 3.5+ support.
• Current compatibility with modern versions of aiohttp, PyYAML, and oauthlib given the aging maintenance status.
• Whether MAAS API changes since August 2022 have rendered parts of the library obsolete or incompatible.

Package facts

Evidence: python_libmaas-0.6.8-py3-none-any.whl

Tags

More Libraries packages