# tomerfiliba/plumbum

Plumbum: Shell Combinators

Repository: https://github.com/tomerfiliba/plumbum
Canonical: https://ross.abutalabs.com/products/plumbum
Homepage: https://plumbum.readthedocs.io
Language: Python
License: MIT
License Family: permissive
Last push: 2026-08-13T16:35:03+00:00

## Health v2 (maintenance only)
Score: 88/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 97, release rhythm 70, longevity 100
- inputs: {"age_days": 5241, "days_push": 20, "days_rel": 42, "gap_med": 129.0, "n_releases_24m": 5}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3051, forks 210 (observed 2026-08-28T04:07:39.634780+00:00)

## What it is
Plumbum is a Python library for writing shell-script-like programs with a Pythonic, cross-platform syntax. It provides local and remote command execution over SSH, path manipulation, environment handling, and a CLI application toolkit.

## Use cases
- run shell commands from python
- replace bash scripts with python
- execute commands over ssh in python
- pipe shell commands in python
- build cli applications in python
- manipulate remote files over ssh

## When to choose
- you want shell script compactness in a real programming language
- you need cross-platform process execution without shelling out to bash
- you need to run commands on remote machines over ssh from python

## When to avoid
- you only need a one-off subprocess call and prefer the stdlib
- you need async-first process management as the primary design
- you need a full configuration management or orchestration tool

## Facets
- artifact type: library
- maturity: stable
- function: cli, developer-tools, file-system, ssh
- domain: developer-tools
- platform: python, cross-platform, windows
- tags: shell-combinators, subprocess, remote-execution, shell-scripting, command-line, automation, linux, macos

## Member repositories
- tomerfiliba/plumbum (main) score 88

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:39.634780+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T07:28:54.267548+00:00, confidence not recorded.
  - readme: https://github.com/tomerfiliba/plumbum (fetched 2026-08-28T04:07:39.634780+00:00, sha 1a7c0f364bed)
  - registry_pypi: https://pypi.org/pypi/plumbum/json (fetched 2026-08-29T09:44:28.717202+00:00, sha ddd971281dc7)
- Data as of 2026-08-30T08:39:29.467469+00:00.