---
id: maas-api
version: "0.1.1"
license: unclear
license_treatment: unclear
maintenance: abandoned
---

# maas-api — An api client library for MAAS.io

License: unclear · Maintenance: abandoned · Downloads: 510.5K/mo

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

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

- License: not declared (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: abandoned
- Downloads: 510.5K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

MAAS API client, metal as a service python, bare metal provisioning API, MAAS machine management, infrastructure automation MAAS, server allocation API, MAAS deployment client, bare-metal-provisioning, abandoned

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