---
id: sarge
version: "0.1.8"
license: BSD-3-Clause
license_treatment: permissive
maintenance: aging
---

# sarge — A wrapper for subprocess which provides command pipeline functionality.

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

## What it is and what it does

Sarge is a thin wrapper around Python's subprocess module that lets you write shell-like command pipelines in Python code using familiar POSIX syntax. Instead of building complex subprocess calls or shelling out to the OS, you write pipelines as strings with pipes (|), chains (;), background execution (&), and redirection, and sarge handles the cross-platform details.

It's designed for developers and system administrators who need to orchestrate external commands from Python without dropping into raw subprocess boilerplate or shell escaping headaches. The package has no runtime dependencies and works on Windows, macOS, and Unix variants, making it useful for portable automation scripts.

Use it for:

- Build automation scripts that chain multiple command-line tools with pipes and redirects without subprocess boilerplate
- System administration tasks that need to run shell-like pipelines portably across Windows and Unix
- Testing or CI workflows where you need to capture and chain command output without shell injection risk
- Data processing scripts that filter or transform output from external tools using familiar pipe syntax

## Worth the install?

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

Sarge wraps Python's subprocess module to provide POSIX-style command pipelines with chains, pipes, and redirection on Windows, macOS, and Unix.

Yes, if you need portable shell-like pipelines in Python. The package is stable (Production/Stable status), has zero dependencies, installs easily, and carries no known vulnerabilities. The aging maintenance status (206 days since last release) is a minor concern for a mature library, but the repository is active and the codebase is straightforward. Install it if subprocess boilerplate is slowing you down.

## Install

pip install sarge
uv add sarge
poetry add sarge

## Installing sarge

Before you install: Low friction: pure Python wheel with no runtime dependencies. Maintenance is aging—last release was 206 days ago—but the repository is active and not archived, with recent commits as of 2026-01-20.

License in practice: BSD-3-Clause is permissive; you can use, modify, and distribute sarge with minimal restrictions, provided you include the license notice.

Quickstart:

pip install sarge

from sarge import run
run('echo hello | cat')

Verify before relying:

- Whether the package actively maintains compatibility with Python 3.14 or if classifiers are aspirational
- Current test coverage and whether unit tests pass on all advertised Python versions

## Package facts

- License: BSD-3-Clause (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: aging
- Downloads: 268.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

subprocess wrapper, command pipelines, shell command chains, cross-platform subprocess, pipe and redirect commands, POSIX shell syntax python, subprocess-wrapper, shell-pipelines, cross-platform

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