Supported Platforms

Debian is the primary PySH development and validation platform. All releases are tested on Debian first. Full support for Debian stable and testing.

• Primary development platform
• All releases validated on Debian
• apt package ecosystem integration
• systemd service support
• Full Python 3.13+ compatibility

FreeBSD is a supported platform, strengthening PySH as a serious Unix-like automation platform. Core features are validated on FreeBSD.

• Core shell features supported
• Python 3.13 via ports/pkg
• BSD-compatible subprocess handling
• Ports collection integration
• Minor feature differences noted in docs

Ubuntu Linux is widely used by developers and DevOps engineers. PySH is expected to work cleanly on Ubuntu LTS releases with Python 3.12+.

• Ubuntu LTS compatibility
• apt package ecosystem
• snap integration potential
• WSL2 compatibility
• GitHub Actions workflows

Fedora represents modern Linux development environments and modern package workflows. Integration is planned for upcoming PySH releases.

• dnf package ecosystem
• Modern Python tooling
• SELinux compatibility checks
• Fedora-specific Python paths
• RPM packaging exploration

macOS is widely used by developers. PySH is designed to work on macOS via Homebrew and pyenv. Full macOS support is on the roadmap.

• Homebrew installation
• pyenv and virtualenv support
• Zsh → PySH migration path
• macOS system Python compatibility
• Terminal.app and iTerm2 support

Windows support via WSL2 is a long-term future target. PySH is Python-native, which makes cross-platform operation technically feasible.

• WSL2 (Ubuntu) support
• Windows Python compatibility research
• PowerShell migration reference
• Windows path handling
• Windows service automation