Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

pip_runner

pip_runner is a small, extendable Python wrapper around the pip command-line interface.
It provides a thin, high-level API that executes python -m pip and parses commonly used outputs (freeze / list).

Overview

Key features

  • Thin wrapper using subprocess to run pip commands via Python executable.

  • High-level Pip class with convenient methods: install, uninstall, list_installed, freeze, show, search, download, wheel, help.

  • Easy to extend, test and integrate with virtual environments (pass custom python_executable).

PyPI record.

Documentation.

Usage

Basic usage:

from pip_runner import Pip
pip = Pip()
pip.install("requests")
print(pip.list().get("requests"))

Installation

Prerequisites:

To install run:

python -m pip install --upgrade pip_runner

Development

Prerequisites:

  • Development is strictly based on nox. To install it run:

    python -m pip install --upgrade nox

Visit Development page.

Installation from sources:

clone the sources:

git clone https://github.com/karpierz/pip_runner pip_runner

and run:

python -m pip install ./pip_runner

or on development mode:

python -m pip install --editable ./pip_runner

License

Copyright (c) 2026-2026 Adam Karpierz
Licensed under the zlib/libpng License
Please refer to the accompanying LICENSE file.

Authors

Sponsoring

If you would like to sponsor the development of this project, your contribution is greatly appreciated.
As I am now retired, any support helps me dedicate more time to maintaining and improving this work.

Donate

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pip_runner-0.2.0a1.tar.gz (39.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pip_runner-0.2.0a1-py3-none-any.whl (13.2 kB view details)

Uploaded Python 3

File details

Details for the file pip_runner-0.2.0a1.tar.gz.

File metadata

  • Download URL: pip_runner-0.2.0a1.tar.gz
  • Upload date:
  • Size: 39.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.13.15

File hashes

Hashes for pip_runner-0.2.0a1.tar.gz
Algorithm Hash digest
SHA256 2a5a1ae73a20fc91fd7c1ade880b75e5c8027a53d02579c03c7ff13f279f2eab
MD5 b107664aabec5083c96c8d9a1537e7d5
BLAKE2b-256 edbf67b702e19aa0cf7e1e667e27186173ecce1714505ec1b25a848ce4c9a0b6

See more details on using hashes here.

File details

Details for the file pip_runner-0.2.0a1-py3-none-any.whl.

File metadata

  • Download URL: pip_runner-0.2.0a1-py3-none-any.whl
  • Upload date:
  • Size: 13.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.13.15

File hashes

Hashes for pip_runner-0.2.0a1-py3-none-any.whl
Algorithm Hash digest
SHA256 239c6c2842b4f83442b0cc17d1eec81a2966f1fdaeed0f88cffc120986e78060
MD5 438c31407da566ea6006a50adb3697c2
BLAKE2b-256 d8de8c9c25647be6602bbc8878ee0c7d23e6b6aa9835feb0a1c404a9a93d3669

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.2.0a1 This release

2 files

0.0.0

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page