podman-runner

Execute experiments in reproducible Podman containers with provenance capture.

1|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/gp201/agent-skills --skill podman-runner
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: podman-runner
Source: https://github.com/gp201/agent-skills/tree/main/skills/podman-runner
Command: npx skills add https://github.com/gp201/agent-skills --skill podman-runner

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Run experiments inside reproducible Podman containers to ensure consistent environments and auditable provenance.

Core Features & Use Cases

  • Builds or uses a Containerfile-based image and executes commands in a reproducible workspace.
  • Captures provenance data for each run, including config, git status, environment, and command invocation.
  • Supports GPU passthrough when available and binds the project directory for containerized execution in reproducible pipelines.

Quick Start

Run a sample experiment inside a Podman container to reproduce results and generate a runs/<id>/ provenance directory.

Frequently Asked Questions about podman-runner

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run reproducible experiments in Podman containers with provenance tracking?

Run reproducible experiments by executing commands inside Podman containers that generate a unique run-id and capture provenance artifacts like config.yaml, git.txt, env.txt, and logs within a runs/<id>/ directory. This ensures consistent environments and easy reproduction of prior runs.

What provenance data is captured when running containerized experiments?

Provenance data captured includes config.yaml, git.txt, env.txt, cmd.txt, and comprehensive execution logs. These artifacts are stored within the runs/<id>/ directory to provide an auditable record of the environment, git status, and command invocation for each experiment.

Can I use GPU passthrough when executing experiments in Podman containers?

Yes, GPU passthrough is supported when available during containerized experiment execution. The runner automatically coordinates GPU access during the execution phase to enable hardware-accelerated workloads while maintaining reproducible provenance capture.

Does podman-runner require a Containerfile to build images for reproducible workspaces?

Yes, it builds or uses a Containerfile-based image to execute commands in a reproducible workspace. The Skill coordinates image building to ensure the environment remains consistent across multiple experiment runs.

What's the best way to reproduce a prior experiment run using container provenance directories?

Reproduce prior runs by utilizing the provenance artifacts stored in the runs/<id>/ directory, which contains the exact config, git status, environment variables, and command invocation. This enforces a reproducible workspace by binding the project directory for containerized execution.