PySH logo
PySH
Platform Support

Supported Platforms

PySH 1.0.0 supports declared Unix runtime families rather than a hardcoded list of OS release numbers. CPython 3.13 or newer is required. Tier labels describe the strength of release evidence; exact CI versions are evidence anchors, not installation allowlists.

Tier 1Tier 2Unsupported / unvalidated
DEB

Debian-family Linux

Debian 13 / amd64 / CPython 3.13 reference

Tier 1

Debian-family Linux is a supported PySH runtime family. Debian 13 / amd64 / CPython 3.13 is the exact Tier-1 reference environment used for release evidence; it is an evidence anchor, not an installation allowlist.

  • CPython >=3.13
  • Debian, Ubuntu, Kali Linux, Linux Mint, Pop!_OS and compatible derivatives
  • Full Tier-1 behavioral and language-conformance reference lane
  • Debian package smoke evidence
  • Platform-sensitive PTY, signal, descriptor and startup validation

Exact CI versions define reproducible evidence, not the minimum supported OS release.

BSD

FreeBSD family

FreeBSD 14.4 / amd64 / CPython 3.13 reference

Tier 1

FreeBSD and GhostBSD form the supported FreeBSD runtime family. FreeBSD 14.4 / amd64 / CPython 3.13 is the Tier-1 behavioral and performance reference.

  • CPython >=3.13
  • FreeBSD and GhostBSD runtime family
  • Native FreeBSD behavioral reference lane
  • Native FreeBSD performance reference lane
  • Official reference .pkg built on FreeBSD 14.4
  • FreeBSD 15.x additional package-validation lane

The published .pkg has a native ABI boundary. Do not force-install it on an incompatible ABI; use Python packaging or build the canonical package on the target host.

RPM

Fedora/RedHat - family Linux

Fedora 43 native RPM evidence

Tier 2

Fedora/RedHat-family Linux is supported by the PySH runtime policy. Fedora 43 provides the controlled native RPM install-and-run evidence used by the v1 release contract.

  • CPython >=3.13
  • Fedora, RHEL, Rocky Linux, AlmaLinux, CentOS Stream and compatible derivatives
  • Native RPM install-and-run smoke
  • No dedicated full Tier-1 behavioral/conformance reference lane yet

Tier 2 is supported, but has a lower level of independent reference evidence than Tier 1.

OTHER

Other OS families

Not covered by the PySH v1 support contract

Unsupported / unvalidated

Native Windows, macOS, and other undeclared OS families do not have a PySH v1 runtime-support claim.

  • No native Windows v1 support claim
  • No macOS v1 support claim
  • No POSIX /bin/sh replacement claim
  • WSL uses the support contract of the Linux distribution running inside WSL

A platform becomes supported only after an explicit runtime-family, capability, and evidence decision.

Installation

install — PyPI

$ python3.13 -m pip install --upgrade pip

$ python3.13 -m pip install pysh-shell

$ pysh --version

$ python -m pysh --version

$ pysh --credits

Native .deb, .rpm, and FreeBSD .pkg files are published as GitHub Release assets. They are not claimed to be packages from the official Debian, Ubuntu, Fedora, RHEL/EPEL, or FreeBSD package repositories.

Full installation and verification guide

Ready to get started?

Install PySH on a supported runtime family and start writing Python automation today.

Read Installation Guide Visit Academy