Stable release: PySH 1.0.0 · CPython 3.13+ · Linux · FreeBSD

PySH

Python-Native Automation

The Python-Native
Automation Platform

for Developers, System Administrators,
and DevOps Engineers

PySH is a stable Python-first interactive shell and script runner for Unix-like systems. Combine shell commands with real Python, structured diagnostics, deterministic configuration, migration tooling, and a versioned plugin API.

Get Started Visit Academy View on GitHub

pip installpysh-shell

CPython 3.13+

·GPL-2.0-only

PySH — Interactive Shell

Python Command Execution Layer

PySH — Block Execution Mode

PySH — Interactive Shell

Python Command Execution Layer

PySH — Block Execution Mode

Ecosystem

Trusted Technologies and Ecosystem

Built around Python and modern developer tools. PySH integrates with the platforms and editors you already use.

Python

Active

Python is the foundation of PySH automation, scripting, and all workflows.

PySH

Active

Python-native interactive shell replacing fragile Bash scripting.

PySH Academy

Active

Structured Python automation courses for admins and DevOps engineers.

GitHub

Active

Source code, issues, releases, and open-source collaboration.

PyPI

Active

Official Python package distribution — pip install pysh-shell.

VS Code

Planned

Terminal profiles, snippets, and plugin development tooling.

JetBrains

Planned

Professional Python and DevOps automation IDE integration.

Debian

Primary

Tier 1 reference for Debian-family Linux: Debian 13 / amd64 / CPython 3.13.

Fedora

Supported

RPM-family Linux is Tier 2; Fedora 43 provides native RPM install-and-run evidence.

FreeBSD

Primary

Tier 1 reference: FreeBSD 14.4 / amd64 / CPython 3.13, with FreeBSD 15 validation.

Windows

Future

No native Windows v1 support claim. WSL uses the support contract of its Linux distribution.

ECLI

Planned

Editor and engineering workspace layer integrating with PySH.

Logos are used for ecosystem and integration reference only. PySH is not officially endorsed by these vendors unless explicitly stated. Please review each brand's trademark policy.

Core Feature

Python Command
Execution Layer

PySH includes a Python Command Execution Layer that lets developers and administrators move from shell commands into Python-powered automation — without leaving the command-line workflow.

Interactive Python mode — run Python code line by line
Block execution mode — run multi-line Python blocks
Full access to the Python standard library and PyPI
Seamless return to shell when finished

Interactive mode — #py

PySH Python Command Execution Layer — interactive REPL mode

>>> standard REPL with full Python 3.13 access

Block execution mode — py { … }

PySH block execution mode — multi-line py blocks

py> { … } execute multi-line Python blocks inline

Shell Design

Prompt Anatomy

The PySH prompt shows your full engineering context at a glance — Python version, active tools, working directory, and system identity.

PySH — real prompt screenshot

Real PySH prompt showing system info, Python, uv, ruff, Node versions

Prompt — rendered preview

🐍ssobol@sun–[~/projects]

py3.13 · uv0.11.17 · ruff0.15.15 · node22.18.0 · npm11.6.0

╰─❯

🐍

PySH identity marker — always visible in the prompt

ssobol@sun

Current Unix user and hostname

[~/projects]

Current working directory path

py3.13

Active Python interpreter version

uv0.11.17

Detected uv package manager version

ruff0.15.15

Detected Ruff linter version

node22.18.0

Detected Node.js runtime version

npm11.6.0

Detected npm package manager version

╰─❯

Command input prompt — awaiting input

Platform

Python Automation Platform Features

The stable v1 platform contract: shell behavior, Python execution, configuration, plugins, portability, diagnostics, and a verifiable software supply chain.

Python-First Shell

A production interactive shell and native script runner that combines Unix command workflows with Python-first automation.

Python Execution Layer

Run persistent inline Python with py and #py, including multi-line automation blocks, without leaving the shell session.

Plugin API 1.0

A versioned trusted-plugin API plus isolated-process plugins with explicit capability grants, IPC contracts, and resource budgets.

Language Contract

A normative PySH language specification backed by a declarative conformance corpus and explicit unsupported-construct rules.

Layered Configuration

Safe declarative TOML, deterministic drop-ins, and an advanced Python configuration layer, with strict --no-rc recovery startup.

Tiered Platform Support

CPython 3.13+ across Debian-family Linux and FreeBSD Tier 1, with RPM-family Linux supported under the Tier 2 contract.

Security & Diagnostics

Threat-modeled startup, structured diagnostics, centralized redaction, optional audit logging, and bounded robustness controls.

Verifiable Releases

Reproducible package evidence, SHA-256 checksums, SPDX 2.3 SBOMs, and GitHub Artifact Attestations for published release assets.

Why PySH

PySH vs Traditional Shell Scripting

Use shell syntax where it fits, and move larger automation logic into maintainable, testable Python without leaving the command-line workflow.

Bash — fragile pipe

# Find all log files

find /var/log -name "*.log" -type f

# Sort by modification time

find /var/log -name "*.log" | xargs ls -lt

PySH — readable Python

from pathlib import Path

for path in Path("/var/log").rglob("*.log"):

if path.is_file():

print(path)

Area	Traditional Shell	PySH
Automation language	Shell-specific syntax	PySH commands + real Python
Larger automation logic	Pipelines, functions, external tools	Python modules, types, functions, exceptions
Testing	Shell-oriented test tooling	pytest / unittest for Python automation
Error handling	Exit codes, set -e, traps	Exit codes plus Python exceptions and logging
Package ecosystem	External CLI and shell tooling	Python stdlib and installed Python packages
IDE support	Shell-language tooling	Python language tooling for automation code
Extension model	Functions, scripts, shell plugins	Versioned Plugin API 1.0 and isolated plugins