---
id: python-magnumclient
version: "4.11.0"
license: unclear
license_treatment: permissive
maintenance: active
---

# python-magnumclient — Client library for Magnum API

License: permissive · Maintenance: active · Downloads: 111.8K/mo

## What it is and what it does

python-magnumclient is a Python library and CLI tool that wraps the OpenStack Magnum API, which manages container cluster infrastructure. It lets you programmatically provision, configure, and manage container clusters on OpenStack infrastructure. The package provides both a Python module for scripting and a command-line interface (magnum command) for interactive cluster operations.

The client handles authentication via keystoneauth1, serialization via oslo libraries, and integrates with the broader OpenStack SDK ecosystem. It depends on 13 runtime packages including requests for HTTP, cryptography for security operations, and PrettyTable for formatted CLI output. The package supports Python 3.8, 3.9, 3.10, and 3.11 and is actively maintained by the OpenStack community.

Use it for:

- Automate provisioning of container clusters on OpenStack infrastructure via Python scripts
- Manage container cluster lifecycle (create, update, delete) from CI/CD pipelines
- Query and monitor cluster status and node information programmatically
- Integrate container orchestration into larger OpenStack infrastructure-as-code workflows
- Use the magnum CLI tool to interactively manage clusters from the command line

## Worth the install?

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

Python bindings and command-line tool for the OpenStack Magnum API, enabling programmatic management of container clusters.

Yes, if you manage container clusters on OpenStack. The package is actively maintained, has low install friction, carries no known vulnerabilities, and is licensed permissively. It is the standard client for Magnum API interaction. Install only if you have a Magnum deployment or plan to use OpenStack container services.

## Install

pip install python-magnumclient
uv add python-magnumclient
poetry add python-magnumclient

## Installing python-magnumclient

Before you install: Low install friction with a pure-Python wheel. Active maintenance (last release 42 days ago). Depends on 13 runtime packages including core OpenStack libraries (keystoneauth1, openstacksdk, osc-lib) and standard utilities, all of which are well-maintained.

License in practice: Licensed under Apache License, Version 2.0 (permissive). No restrictions on use, modification, or distribution in commercial or private projects.

Quickstart:

pip install python-magnumclient

from magnumclient import client
mgm_client = client.Client('1', endpoint='http://magnum-api/v1')

Requires an accessible Magnum API endpoint and valid OpenStack credentials (typically via environment variables or keystone authentication).

Verify before relying:

- Specific Magnum API versions supported by this client release
- Whether the package works with non-OpenStack Magnum deployments
- Performance characteristics under high-volume API calls

## Package facts

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

## Tags

openstack magnum client, container cluster management api, magnum python bindings, openstack container orchestration, magnum command-line tool, kubernetes cluster provisioning, container infrastructure as code, openstack, container-orchestration

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