https://github.com/cicirello/pyaction

A Docker container with Python, git, and the Github CLI

https://github.com/cicirello/pyaction

Science Score: 26.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
  • Committers with academic emails
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (9.2%) to scientific vocabulary

Keywords

curl docker docker-image gh git github-actions github-api github-cli gpg linux python

Keywords from Contributors

sequences hack autograder projections interpretability standardization meshing actions control evolutionary-algorithms
Last synced: 5 months ago · JSON representation

Repository

A Docker container with Python, git, and the Github CLI

Basic Info
Statistics
  • Stars: 34
  • Watchers: 1
  • Forks: 8
  • Open Issues: 0
  • Releases: 52
Topics
curl docker docker-image gh git github-actions github-api github-cli gpg linux python
Created over 5 years ago · Last pushed 6 months ago
Metadata Files
Readme Changelog License

README.md

pyaction

pyaction - A Docker container with Python, git, and the GitHub CLI

Website for our GitHub Actions and tools for developing them: https://actions.cicirello.org/

Summary

| Docker Hub | Docker Image Version (latest by date) Docker Pulls | | :--- | :--- | | GitHub | GitHub Container Registry (latest by date) | | Image Stats | Docker Image Size (latest by date) | | Build Status | build | | License | License | | Support | GitHub Sponsors Liberapay Ko-Fi |

This Docker image is designed to support implementing Github Actions with Python. It starts with the official python docker image as the base, which is a Debian OS. It specifically uses python:3-slim to keep the image size down for faster loading of Github Actions that use pyaction. On top of the base, we've installed curl, gpg, git, and the GitHub CLI. We added curl and gpg because they are needed to install the GitHub CLI, and they may come in handy anyway (especially curl) when implementing a GitHub Action.

Blog Posts: See a list of blog posts about pyaction later in this README.

Multiplatform Image

pyaction supports the following platforms: * linux/386 * linux/amd64 * linux/arm64 * linux/arm/v7 * linux/arm/v6

Source Repository and Builds

The source repository is maintained on GitHub. The images are built on Github and pushed to Docker Hub, as well as the Github Container Registry using Github Actions.

Our daily automated CI/CD processes monitor for updates to the Python slim Docker image, the GitHub CLI, etc. Upon detecting such updates, we release an update of pyaction sometimes as early as same day, but possibly a few days later.

See versions.json for details of versions of Python, GitHub CLI, git, etc included in the latest build.

Docker Tags and Versioning Scheme

For the current version of Python (e.g., 3.13.5) and current version of GitHub CLI (e.g., 2.75.0), all of the following tags are available and equivalent: latest, 3.13.5, 3.13, 3.13.5-gh-2.75.0, 3.13.5-gh-2.75, 3.13.5-gh-2, 3.13-gh-2.75.0, 3.13-gh-2.75, 3.13-gh-2.

For prior versions of Python (e.g., 3.12) and current version of GitHub CLI (2.75.0), all of the following tags are available and equivalent: 3.12, 3.12-gh-2.75.0, 3.12-gh-2.75, 3.12-gh-2. Note that we only build new images for Python versions that are still supported, and not for any that have reached end-of-life. See the official Status of Python Versions.

This tag scheme began with version 2.75.0 of the GitHub CLI. We don't support pyaction images with earlier versions of the GitHub CLI.

This tag scheme began with Python 3.13.5. Python patch level tags are not available for pyaction prior to Python 3.13.5.

Installation and Usage

The pre-built image is hosted on both Docker Hub and the Github Container Registry. You can use it in the following ways.

Docker Pull Command

Pull the latest image from Docker Hub with the following (replace latest with a specific version number if you prefer):

Shell docker pull cicirello/pyaction:latest

Pull from the Github Container Registry with:

Shell docker pull ghcr.io/cicirello/pyaction:latest

Use as a base image in a Dockerfile

Use as a base image in a Dockerfile (replace latest with a specific version number if you prefer):

```Dockerfile FROM cicirello/pyaction:latest

The rest of your Dockerfile would go here.

```

Or you can use as a base image (via the Github Container Registry) with:

```Dockerfile FROM ghcr.io/cicirello/pyaction:latest

The rest of your Dockerfile would go here.

```

Blog Posts

Here are a few blog posts about the pyaction container listed in reverse chronological order: * pyaction: Python and the GitHub CLI in a Docker Container, posted on August 14, 2025. * pyaction pulled 4 million times and counting from the GitHub Container Registry, posted on May 31, 2024. * Celebrating over 2 million pulls of pyaction from the GitHub Container Registry, posted on September 2, 2023. * pyaction: Over 1 million pulls from the GitHub Container Registry, posted on February 16, 2023. * pyaction: A Docker container with Python, git, and the GitHub CLI, posted on December 28, 2022.

License

Source Code License

The source code, including the Dockerfile and anything else within the Github repository for pyaction, is licensed under the MIT License.

Image Licenses

As with all pre-built Docker images, the image itself (once built, or obtained from Docker Hub or the Github Container Registry) contains software that is covered by a variety of licenses. See the license information for the python docker image, the license for git, the GitHub CLI, and the license for Python.

If you build and distribute an image containing your software, using pyaction as the base image, it is your responsibility to follow the licenses of all of the software contained within the image.

Owner

  • Name: Vincent A. Cicirello
  • Login: cicirello
  • Kind: user
  • Location: Galloway, NJ
  • Company: Stockton University

Vincent A. Cicirello is a researcher in AI, evolutionary computation, and swarm intelligence.

GitHub Events

Total
  • Create event: 42
  • Issues event: 2
  • Release event: 2
  • Watch event: 4
  • Delete event: 41
  • Issue comment event: 4
  • Push event: 55
  • Pull request review event: 38
  • Pull request event: 86
  • Fork event: 1
Last Year
  • Create event: 42
  • Issues event: 2
  • Release event: 2
  • Watch event: 4
  • Delete event: 41
  • Issue comment event: 4
  • Push event: 55
  • Pull request review event: 38
  • Pull request event: 86
  • Fork event: 1

Committers

Last synced: 7 months ago

All Time
  • Total Commits: 335
  • Total Committers: 3
  • Avg Commits per committer: 111.667
  • Development Distribution Score (DDS): 0.281
Past Year
  • Commits: 66
  • Committers: 3
  • Avg Commits per committer: 22.0
  • Development Distribution Score (DDS): 0.288
Top Committers
Name Email Commits
Vincent A. Cicirello c****o 241
dependabot[bot] 4****] 83
github-actions[bot] 4****] 11

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 6
  • Total pull requests: 259
  • Average time to close issues: 4 days
  • Average time to close pull requests: 1 day
  • Total issue authors: 4
  • Total pull request authors: 3
  • Average comments per issue: 1.5
  • Average comments per pull request: 0.07
  • Merged pull requests: 239
  • Bot issues: 1
  • Bot pull requests: 209
Past Year
  • Issues: 3
  • Pull requests: 79
  • Average time to close issues: 5 days
  • Average time to close pull requests: about 18 hours
  • Issue authors: 3
  • Pull request authors: 3
  • Average comments per issue: 3.0
  • Average comments per pull request: 0.01
  • Merged pull requests: 71
  • Bot issues: 1
  • Bot pull requests: 72
Top Authors
Issue Authors
  • cicirello (3)
  • github-actions[bot] (2)
  • moui72 (1)
  • wbenoit26 (1)
Pull Request Authors
  • github-actions[bot] (160)
  • dependabot[bot] (101)
  • cicirello (60)
Top Labels
Issue Labels
bug (3) dependencies (1) enhancement (1)
Pull Request Labels
dependencies (100) github_actions (62) docker (46) documentation (20) invalid (4) enhancement (1)

Packages

  • Total packages: 1
  • Total downloads: unknown
  • Total dependent packages: 0
  • Total dependent repositories: 0
  • Total versions: 52
proxy.golang.org: github.com/cicirello/pyaction
  • Versions: 52
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent packages count: 5.5%
Average: 5.7%
Dependent repos count: 5.9%
Last synced: 6 months ago

Dependencies

.github/workflows/docker-image.yml actions
  • actions/checkout v3 composite
  • peter-evans/create-pull-request v4.2.3 composite
.github/workflows/docker-manual-publish.yml actions
  • actions/checkout v3 composite
  • docker/build-push-action v3 composite
  • docker/login-action v2 composite
  • docker/setup-buildx-action v2 composite
  • docker/setup-qemu-action v2 composite
.github/workflows/docker-publish.yml actions
  • actions/checkout v3 composite
  • docker/build-push-action v3 composite
  • docker/login-action v2 composite
  • docker/setup-buildx-action v2 composite
  • docker/setup-qemu-action v2 composite
Dockerfile docker
  • python 3.11.1-slim build