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.