---
id: podman
version: "5.8.0"
license: Apache License Version 2.0, January 2004 http://www.apache.org/licenses/ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 1. Definitions. "License" shall mean the terms and conditions for… (full text in the JSON record)
license_treatment: permissive
maintenance: active
---

# podman — Bindings for Podman RESTful API

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

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

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

- License: Apache License Version 2.0, January 2004 http://www.apache.org/licenses/ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 1. Definitions. "License" shall mean the terms and conditions for… (full text in the JSON record) (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 706.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

podman python bindings, container management api, podman rest client, programmatic container control, libpod python library, podman container orchestration, container runtime python, container-management, rest-client, podman

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