podman

What it is and what it does

Podman is a Python library that wraps the Podman container engine's RESTful API, letting you interact with containers and images from Python code instead of shell commands. It connects to a running Podman daemon (typically via a Unix socket) and provides object-oriented access to list, inspect, create, and manage containers and images. The library depends on requests, tomli, and urllib3 for HTTP communication and configuration parsing.

You use it by instantiating a PodmanClient with a URI pointing to your Podman daemon, then calling methods on that client to query or manipulate containers and images. The example in the documentation shows retrieving version info, listing images, iterating over containers, and checking their status. It's designed for developers who want to automate container operations from Python rather than shelling out to the Podman CLI.

Use it for:

• Automate container lifecycle management (start, stop, remove) from Python applications or scripts
• Build container orchestration or monitoring tools that query Podman daemon state programmatically
• Integrate container operations into CI/CD pipelines or deployment automation written in Python
• Query container and image metadata (status, IDs, attributes) without parsing CLI output
• Develop testing frameworks that spin up and tear down containers on demand via Python code

Worth the install?

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

Provides Python bindings to the Podman container engine's RESTful API, allowing you to manage containers, images, and other Podman resources programmatically.

Yes. The package is actively maintained, has no known vulnerabilities, installs with low friction, uses a permissive Apache 2.0 license, and supports current Python versions (3.9–3.13). Install it if you need programmatic control over Podman from Python; skip it if you only use Podman via the CLI or don't need container automation in your codebase.

Install

podman on PyPI

pip install podman

uv add podman

poetry add podman

Installing podman

Before you install

Low install friction with a pure-Python wheel distribution. Maintenance is active with a recent release and ongoing repository activity.

License in practice

Licensed under Apache License 2.0 (permissive), allowing use in commercial and proprietary projects with minimal restrictions beyond attribution and license inclusion.

Quickstart

pip install podman

from podman import PodmanClient

uri = "unix:///run/user/1000/podman/podman.sock"
with PodmanClient(base_url=uri) as client:
    version = client.version()
    for image in client.images.list():
        print(image)

Requires a running Podman daemon accessible via Unix socket or TCP; the package currently supports Unix domain sockets only.

Verify before relying

• Whether TCP connection support is planned or available in versions beyond 5.8.0
• Performance characteristics and latency overhead compared to direct Podman CLI invocation
• Compatibility matrix with specific Podman daemon versions

Package facts

Evidence: podman-5.8.0-py3-none-any.whl

Keywords: libpod, podman

Tags

More Python Modules packages