New: PySH 0.8.2 — Python 3.13.5 · uv 0.11.17 · Ruff 0.15.15

PySH

Python-Native Automation

The Python-Native
Automation Platform

for Developers, System Administrators,
and DevOps Engineers

PySH brings Python-native automation into the command line. Write real Python, replace fragile shell scripts, run automation blocks, and extend workflows with plugins.

Get Started Visit Academy View on GitHub

pip installpysh-shell

Python 3.13.5

·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

Primary PySH development and validation platform.

Fedora

Active

Modern Linux development environment and package workflows.

FreeBSD

Active

Strengthens PySH as a serious Unix-like automation platform.

Windows

Planned

WSL2 is the supported Windows path today, with full PySH semantics.

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

Everything you need to build, automate, and maintain professional Python engineering workflows.

Python-Native Shell

An interactive shell built around Python. Run system commands and Python scripts from the same workflow — no context switching.

Python Execution Layer

Switch into Python-mode seamlessly — interactive REPL or block execution — without leaving the command line.

Plugin Ecosystem

Extend PySH with Python-powered plugins. Git, Docker, AWS, monitoring — each as a clean, testable Python module.

PySH Academy

Structured courses to replace Bash scripting with maintainable Python automation. For admins and DevOps engineers.

TOML Configuration

Configure PySH with readable TOML. Prompt themes, plugins, history, and environment — all in one file.

Multi-Platform Support

Primary on Debian and Linux. Validated on FreeBSD. Windows and macOS on the roadmap.

Safe Automation

Python scripts are readable, testable, and auditable. Replace fragile shell pipes with maintainable Python logic.

ECLI Integration

ECLI provides the editor and engineering workspace layer designed to integrate seamlessly with PySH workflows.

Why PySH

PySH vs Traditional Shell Scripting

Replace fragile Bash/Zsh scripts with maintainable, readable, and extensible Python automation.

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 syntax (Bash/Zsh)	Real Python
Readability after 6 months	Fragile, cryptic	Readable Python
Testing	Difficult or impossible	pytest, unittest
Error handling	set -e, traps	try/except, logging
Package ecosystem	Limited	All of PyPI
IDE support	Basic syntax only	Full Python IDE support
Plugin model	Shell functions	Python packages