---
id: patchwork
version: "1.0.1"
license: BSD
license_treatment: permissive
maintenance: abandoned
---

# patchwork — Deployment/sysadmin operations, powered by Fabric

License: permissive · Maintenance: abandoned · Downloads: 89.4K/mo

## What it is and what it does

Patchwork is a mid-level library of system administration primitives designed to run over SSH via Fabric. It provides functions like package installation and user account creation that are built to be idempotent—safe to call repeatedly without accumulating unwanted side effects. Unlike larger configuration management frameworks, Patchwork is just an API with no concept of recipes or roles; it leaves organizational structure to the user or wrapping libraries. Functions expect a context object and can run either locally or remotely depending on the context supplied.

The library is implemented through shell calls, typically sent over SSH from a local workstation. It sits between raw shell scripting and full configuration management systems, offering a lightweight alternative for teams that want programmatic control over deployment operations without the overhead of a complete framework.

Use it for:

- Automating package installation and system configuration on remote servers via SSH from a Python script.
- Building custom deployment workflows that need idempotent operations without adopting a full configuration management framework.
- Writing ad-hoc system administration tasks that can be safely re-run without causing errors or duplicate changes.
- Wrapping Patchwork primitives in higher-level deployment or provisioning tools tailored to specific organizational needs.

## Worth the install?

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

Patchwork provides idempotent Unix system administration primitives—such as package installation and user account creation—built on top of Fabric for remote execution over SSH.

No. While Patchwork offers a useful lightweight alternative to full configuration management frameworks, it has been abandoned since 2018 with no maintenance. The package is unlikely to work reliably on modern Python versions or current system environments. For new projects, consider actively maintained alternatives.

## Install

pip install patchwork
uv add patchwork
poetry add patchwork

## Installing patchwork

Before you install: Low friction installation. However, the package has been abandoned since 2018 with no recent maintenance, so it may not work reliably with modern Python or system environments.

License in practice: BSD license is permissive, allowing commercial and private use with minimal restrictions, making it suitable for most deployment contexts.

Quickstart:

pip install patchwork

from patchwork.files import exists

if exists(ctx, '/etc/hosts'):
    print('File exists')

Requires Fabric; designed for remote execution over SSH, typically called with a remote context object rather than local execution.

Verify before relying:

- Whether Patchwork's Fabric dependency still installs and functions on modern Python versions given the package's abandonment since 2018.
- Compatibility with current SSH implementations and modern Unix/Linux distributions.
- Whether the idempotency guarantees hold across different system configurations and package managers.

## Package facts

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

## Tags

unix system administration primitives, idempotent deployment operations, fabric-based remote sysadmin, ssh system configuration, package installation automation, remote server provisioning, deployment automation library, sysadmin-automation, ssh-deployment, abandoned

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