{"library":"podman","title":"Podman Python Client","description":"Podman-py provides Python bindings for the Podman RESTful API, enabling programmatic interaction with Podman containers, images, networks, and pods. As of version 5.8.0, it offers a comprehensive client for managing Podman resources. The project is actively maintained with frequent minor releases, typically on a monthly or bi-monthly cadence, introducing new features and bug fixes.","language":"python","status":"active","last_verified":"Sun May 17","install":{"commands":["pip install podman"],"cli":{"name":"podman","version":"sh: 1: podman: not found"}},"imports":["from podman import PodmanClient"],"auth":{"required":false,"env_vars":[]},"quickstart":{"code":"import podman\nimport os\n\n# By default, PodmanClient attempts to connect to the Podman socket based on environment variables\n# (e.g., PODMAN_HOST) or standard locations (e.g., /run/user/$UID/podman/podman.sock).\n# You can also explicitly specify a base_url, e.g., for a remote Podman service or specific socket.\n\n# Example using default connection (rootless or rootful Podman socket):\ntry:\n    client = podman.PodmanClient()\n    info = client.system.info()\n    print(f\"Connected to Podman. Version: {info['Version']}\")\n    \n    # Example: List containers\n    print(\"\\nRunning containers:\")\n    for container in client.containers.list():\n        print(f\"  - {container.name} ({container.id[:12]})\")\n\nexcept Exception as e:\n    print(f\"Error connecting to Podman or executing command: {e}\")\n    print(\"Ensure Podman is running and accessible (e.g., 'systemctl --user start podman.socket' for rootless).\")\n\n# Example with explicit base_url (uncomment to test specific connections)\n# rootless_socket = os.environ.get('XDG_RUNTIME_DIR', '/run/user/1000') + '/podman/podman.sock'\n# try:\n#     client_socket = podman.PodmanClient(base_url=f'unix://{rootless_socket}')\n#     info_socket = client_socket.system.info()\n#     print(f\"\\nConnected via explicit socket. Version: {info_socket['Version']}\")\n# except Exception as e:\n#     print(f\"Error connecting via explicit socket: {e}\")","lang":"python","description":"This quickstart demonstrates how to initialize `PodmanClient` to connect to a running Podman daemon. By default, it tries to auto-detect the socket. It then prints system information and lists any running containers. This example is designed to work with both rootful and rootless Podman installations, assuming the default socket paths.","tag":null,"tag_description":null,"last_tested":null,"results":[]},"compatibility":{"tag":null,"tag_description":null,"last_tested":"2026-05-17","installed_version":"5.8.0","pypi_latest":"5.8.0","is_stale":false,"summary":{"python_range":"3.10–3.9","success_rate":100,"avg_install_s":2.1,"avg_import_s":0.7,"wheel_type":"wheel"},"results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"podman","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.71,"mem_mb":10.9,"disk_size":"22.0M"},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"podman","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":2.1,"import_time_s":0.51,"mem_mb":10.9,"disk_size":"22M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"podman","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.87,"mem_mb":13.3,"disk_size":"24.0M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"podman","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":2.2,"import_time_s":0.74,"mem_mb":13.3,"disk_size":"25M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"podman","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.79,"mem_mb":12.6,"disk_size":"15.8M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"podman","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":1.9,"import_time_s":0.76,"mem_mb":12.6,"disk_size":"16M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"podman","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.74,"mem_mb":13,"disk_size":"15.5M"},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"podman","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":1.9,"import_time_s":0.73,"mem_mb":13,"disk_size":"16M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"podman","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.63,"mem_mb":10.6,"disk_size":"21.2M"},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"podman","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":2.5,"import_time_s":0.57,"mem_mb":10.6,"disk_size":"22M"}]}}