---
id: pypyp
version: "1.3.0"
license: unclear
license_treatment: permissive
maintenance: aging
---

# pypyp — Easily run Python at the shell! Magical, but never mysterious.

License: permissive · Maintenance: aging · Downloads: 108.4K/mo

## What it is and what it does

pyp is a command-line tool that lets you run Python code directly from the shell without boilerplate. You write a Python expression or snippet, and pyp statically analyzes it to infer what you need: it detects undefined variables like `x` (current line), `lines` (all lines), `stdin`, or `i` (loop index), automatically imports any modules you reference, and executes the code with those bindings in place. The result is printed intelligently—dicts and iterables format nicely, and the last expression prints automatically unless it's None or you explicitly call print yourself.

It's designed to replace common shell utilities: `ls | pyp 'x[:3]'` acts like cut, `cat file | pyp 'sum(map(int, lines))'` acts like awk, and `cat data.json | pyp 'json.load(stdin)[0]'` acts like jq. You can also use `--explain` to see the generated Python script before running it, chain multiple pyp invocations, or configure a custom config file (via PYP_CONFIG_PATH) to predefine functions and imports for your own use cases.

Use it for:

- Extract or transform text line-by-line: `ls | pyp 'x.upper()'` or `cat file | pyp 'x.split()[2]'`
- Aggregate or filter input: `cat data | pyp 'sum(map(int, lines))'` or `cat words | pyp 'x if "python" in x else None'`
- Process structured data: `curl api | pyp 'json.load(stdin)[0]["key"]'` or `cat file.csv | pyp 'len(lines)'`
- Add line numbers or indices: `cat file | pyp 'f"{idx+1}: {x}"'`
- Understand generated code before execution: `pyp --explain 'complex_expression'` to inspect the AST transformation

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

pyp lets you write Python expressions and scripts directly at the shell, automatically handling imports, magic variables for input lines, and intelligent output formatting without requiring explicit print statements.

Yes, if you regularly write one-liners at the shell and want to avoid boilerplate imports and explicit print statements. The low install friction, permissive license, and lack of known vulnerabilities make it safe to try. The aging maintenance status (595 days since last release) is a minor concern for a stable utility, but the active repository and solid user base suggest it remains reliable for its narrow, well-defined purpose.

## Install

pip install pypyp
uv add pypyp
poetry add pypyp

## Installing pypyp

Before you install: Low friction: pure Python wheel with a single runtime dependency (astunparse). Maintenance is aging—last release was 595 days ago—but the repository remains active and unarchived with a modest user base (1528 stars).

License in practice: MIT license (permissive) means you can use, modify, and redistribute pypyp with minimal restrictions, making it safe for both personal and commercial projects.

Quickstart:

pip install pypyp

# In shell:
echo -e "hello\nworld" | pyp 'x.upper()'

# In Python (less common):
import subprocess
result = subprocess.run(['pyp', 'x.upper()'], input=b'hello\n', capture_output=True)
print(result.stdout.decode())

Requires Python 3.8 or above; pyp is primarily a shell command-line tool, not a library for direct Python import.

Verify before relying:

- Whether the --explain output is guaranteed to be runnable Python or merely illustrative
- Performance characteristics when processing very large input streams
- Compatibility with all standard library modules beyond those explicitly mentioned

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 108.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

python one-liners shell, run python from command line, pipe python processing, shell python scripting, python text processing CLI, automatic python imports shell, python line-by-line processing, shell-scripting, one-liners, cli-tool

[View on SkillFed](https://skillfed.io/packages/pypyp) · [View on PyPI](https://pypi.org/project/pypyp/)