Installation

Under Construction

Install PySH on Debian, Ubuntu, FreeBSD, macOS, and WSL2.

Note: PySH requires Python 3.12 or later. Python 3.13 is recommended. PySH is Unix-like first. The supported Windows path is WSL2 with full PySH semantics.

Prerequisites

✓Python 3.12 or later (3.13 recommended)
✓pip or uv package manager
✓A Unix-like operating system: Debian, Ubuntu, FreeBSD, macOS, or WSL2

Install with pip

# Install the latest stable release

$ pip install pysh-shell

# Install a specific version

$ pip install pysh-shell==0.8.2

# Launch PySH

$ pysh

PySH 0.8.2 | Python 3.13.5 | GPL-2.0-only

Install with uv (recommended)

uv is a fast Python package and project manager. Installing PySH as a uv tool makes the pysh command available globally without affecting your project virtualenvs.

Install with uv

# Install uv if not already installed

$ curl -LsSf https://astral.sh/uv/install.sh | sh

# Install PySH as a global tool

$ uv tool install pysh-shell

$ pysh

PySH 0.8.2 | Python 3.13.5 | GPL-2.0-only

FreeBSD

FreeBSD install

# Install Python via pkg

$ pkg install python313

# Install pip

$ pkg install py313-pip

# Install PySH

$ pip install pysh-shell

WSL2 (Windows)

Info: PySH is Unix-like first. The supported Windows path today is WSL2 with full PySH semantics. Install WSL2 with Ubuntu or Debian, then follow the standard Linux installation steps above.

Verify the installation

Verify

$ pysh --version

PySH 0.8.2

$ python3 -c "import pysh; print(pysh.__version__)"

0.8.2