maas-api

What it is and what it does

maas-api is a Python client for MAAS (Metal as a Service), a bare-metal provisioning platform. It dynamically exposes the full MAAS API by introspecting the server's API description endpoint, allowing you to allocate machines, deploy systems, and manage their lifecycle programmatically. The library uses the same technique as the official MAAS CLI to maintain functional parity with server capabilities.

The package depends on requests and requests-oauthlib for HTTP communication and OAuth authentication. It supports Python 3.9 and 3.10. However, the project is abandoned—the last release and repository commit were 2021-10-22, and no updates have been made since. This means it may not work with newer MAAS versions or Python releases, and any bugs or security issues discovered after that date will not be addressed.

Use it for:

• Automate bare-metal machine provisioning workflows by allocating and deploying systems programmatically instead of via the CLI.
• Build infrastructure-as-code tools that manage MAAS resources (machines, networks, storage) from Python applications.
• Integrate MAAS machine lifecycle operations (allocate, deploy, release) into larger orchestration or deployment pipelines.
• Query and manage MAAS resources dynamically by leveraging the server's full API surface without waiting for official client updates.

Worth the install?

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

A Python client library for MAAS (Metal as a Service) that exposes the full MAAS API by introspecting the server's API description endpoint, allowing programmatic machine allocation, deployment, and lifecycle management.

No. The package is abandoned (last update 2021-10-22, repository archived), with no maintenance since. Its license status is unclear, and there is no assurance it will work with current MAAS versions or modern Python environments. Use only if locked to a legacy MAAS deployment; otherwise, seek an actively maintained alternative or use the official MAAS CLI directly.

Install

maas-api on PyPI

pip install maas-api

uv add maas-api

poetry add maas-api

Installing maas-api

Before you install

Low install friction with only two runtime dependencies (requests and requests-oauthlib). However, the package is abandoned—last release and commit were 2021-10-22, and the repository is archived. No updates have been made since.

License in practice

License status is unclear; no SPDX identifier or raw license text is recorded. Before installing, verify the actual license terms from the repository to ensure compatibility with your project.

Quickstart

pip install maas-api

from maas_api import Client

client = Client("http://192.0.2.10:/MAAS", api_key="your:api:key")
machine = client.machines.allocate()
client.machine.deploy(system_id=machine["system_id"])

Requires a running MAAS server accessible at the provided URL with a valid API key for authentication.

Verify before relying

• Whether the package works with current MAAS server versions, given the last release was 2021-10-22.
• Actual license terms and whether they are compatible with your intended use.
• Whether requests and requests-oauthlib versions are pinned or have known compatibility issues.

Package facts

Evidence: maas_api-0.1.1-py3-none-any.whl

Tags

More Internet packages