---
id: actions-python-core
version: "0.1.3"
license: unclear
license_treatment: permissive
maintenance: dormant
---

# actions-python-core — Actions core lib

License: permissive · Maintenance: dormant · Downloads: 133.3K/mo

## What it is and what it does

actions-python-core is a lightweight Python library for building GitHub Actions. It wraps the core functions needed to interact with the GitHub Actions runtime: reading inputs (including boolean and multiline variants), setting outputs for downstream actions, logging, registering secrets, and exporting environment variables. The package depends on aiofiles, httpx, and typing-extensions, and targets Python 3.9+.

The library is in pre-alpha status and has been dormant since its latest release. It appears designed for developers writing custom GitHub Actions in Python who need a thin abstraction over the Actions API rather than a full framework. Users should verify whether it remains compatible with current GitHub Actions infrastructure and whether more actively maintained alternatives better serve their use case.

Use it for:

- Reading and parsing action inputs in a custom GitHub Actions workflow step.
- Setting outputs that downstream actions or workflow steps can consume.
- Logging messages and handling secrets within a Python-based GitHub Action.
- Building lightweight custom CI/CD automation without a full framework.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides core utilities for GitHub Actions written in Python, including input/output handling, logging, secret registration, and variable export.

No—unless you are maintaining an existing codebase that already uses it. The package is dormant (latest release October 2023, last commit June 2024), has minimal adoption, and lacks current documentation. Verify first whether GitHub's official Actions toolkit or a more actively maintained alternative better serves your use case.

## Install

pip install actions-python-core
uv add actions-python-core
poetry add actions-python-core

## Installing actions-python-core

Before you install: Low install friction with a pure-Python wheel. Maintenance is dormant—last release was in October 2023 and the repository shows minimal activity (2 stars, last commit June 2024), so expect no active support or updates.

License in practice: MIT license permits commercial and private use with minimal restrictions, making it safe to adopt from a licensing perspective.

Quickstart:

pip install actions-python-core

from actions import core

my_input = core.get_input("input_name", required=True)
core.set_output("output_key", "output_value")

Requires Python 3.9 or later.

Verify before relying:

- Whether the package is actively maintained or has been superseded by an official GitHub Actions Python toolkit.
- Real-world compatibility with current GitHub Actions runner environments.
- Completeness of the API—the description excerpt ends with 'TBD', suggesting documentation may be incomplete.
- Current adoption and whether the low download volume reflects niche use or declining interest.

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: dormant
- Downloads: 133.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

github actions python library, actions input output handling, github actions core functions, ci/cd python utilities, github workflow automation, github-actions, ci-cd

[View on SkillFed](https://skillfed.io/packages/actions-python-core) · [View on PyPI](https://pypi.org/project/actions-python-core/)