Platform

Python-Native Automation Platform

PySH is a stable Python-first interactive shell and script runner. It is not /bin/sh and not a Bash, Zsh, or Fish clone. The v1 platform combines shell workflows with real Python, a versioned plugin API, structured diagnostics, layered configuration, and verifiable releases.

Get Started View on GitHub

What Is PySH

PySH is a production Python-first shell for developers, system administrators, and DevOps engineers. Release 1.0.0 defines a stable v1 contract for interactive use, native .pysh scripts, embedded Python execution, plugins, configuration, diagnostics, portability, and release verification.

✓Interactive shell plus native .pysh script mode

✓Persistent Python execution with py, #py, and multi-line blocks

✓Plugin API 1.0 plus isolated-process capability contracts

✓Layered TOML and Python configuration with strict --no-rc recovery

✓Structured diagnostics, redaction, and optional audit logging

✓CPython 3.13+ with Tier 1 Debian/FreeBSD and Tier 2 RPM-family support

PySH 1.0.0

PySH 1.0.0 | CPython 3.13+ | GPL-2.0-only

Reference: Debian 13 / amd64 / CPython 3.13

Type 'exit' or press Ctrl+D to quit.

🐍 ssobol@sun – [~]

py3.13 · uv0.11.17 · ruff0.15.15

╰─❯ #py

PySH Python Command Execution Layer

CPython 3.13+

>>> from pathlib import Path

>>> list(Path('.').iterdir())

[PosixPath('scripts'), PosixPath('.env'), ...]

PySH in Action

Product visuals are served from this site repository so the documentation preview does not depend on temporary external image URLs.

PySH shell prompt

PySH prompt with user, host, working directory, Python, uv, Ruff, Node and npm context

Python Command Execution Layer

Multi-line Python block execution

Stable release 1.0.0

PySH 1.0.0

Stable release metadata is loaded automatically from the latest published GitHub Release.

TOML Configuration

PySH uses non-executing TOML for declarative settings and ~/.pyshrc.py for advanced programmable configuration. TOML can configure profiles, themes, prompt behavior, history, aliases, environment, and plugin data without executing commands.

~/.config/pysh/config.toml

[profile]

active = "developer"

[prompt]

prompt_layout = "two_line"

show_git_branch = true

show_last_status = true

[history]

max_length = 10000

dedup_mode = "consecutive"

[alias_packs]

enabled = ["git", "python"]

Platform Capabilities

Interactive Shell & Script Mode

Interactive history, completion, job control, pipelines, redirections, heredocs, and explicit .pysh script execution.

Python Execution Layer

Persistent inline Python, #py interactive mode, and multi-line automation blocks within the same shell workflow.

Plugin API 1.0

Versioned trusted plugins plus isolated-process plugins with explicit capability, IPC, and resource contracts.

Layered Configuration

Declarative TOML, deterministic drop-ins, advanced ~/.pyshrc.py configuration, and strict --no-rc recovery startup.

Diagnostics & Security

Structured JSON diagnostics, centralized redaction, optional private audit logs, fuzz evidence, and bounded resource controls.

Verifiable Supply Chain

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