pypa /pipenv

Python Development Workflow for Humans.

★ 25,024⑂ 1,888👁 346⑃ 2,286● 4,387▤ 145
PythonMITCreated 2017-01-20pipenv.pypa.io
More from this author
Download: Release v2026.11.0Release-2026.11.0 ↓2026.11.02026-11-09
+1
Daily
+4
Weekly
+2
Monthly
25,024
stars
1,888
forks
346
watchers
2,286
prs
4,387
issues
145
releases

README

Pipenv: Python Development Workflow for Humans
==============================================






------------------------------------------------------------------------

Pipenv is a Python virtualenv management tool that supports a multitude of systems and nicely bridges the gaps between pip, python (using system python, pyenv or asdf) and virtualenv.
Linux, macOS, and Windows are all first-class citizens in pipenv.

Pipenv automatically creates and manages a virtualenv for your projects, as well as adds/removes packages from your Pipfile as you install/uninstall packages. It also generates a project Pipfile.lock, which is used to produce deterministic builds.

Pipenv is primarily meant to provide users and developers of applications with an easy method to arrive at a consistent working project environment.

The problems that Pipenv seeks to solve are multi-faceted:

- You no longer need to use pip and virtualenv separately: they work together.
- Managing a requirements.txt file with package hashes can be problematic.  Pipenv uses Pipfile and Pipfile.lock to separate abstract dependency declarations from the last tested combination.
- Hashes are documented in the lock file which are verified during install. Security considerations are put first.
- Strongly encourage the use of the latest versions of dependencies to minimize security risks arising from outdated components.
- Gives you insight into your dependency graph (e.g. $ pipenv graph).
- Streamline development workflow by supporting local customizations with .env files.

Table Of Contents
------------------

- Pipenv

- Installation

- Features

- Basic Concepts

- Other Commands

- Shell Completion

- Usage

    - Usage Examples

    - Commands

    - Locate the Project

    - Locate the virtualenv

    - Locate the Python Interpreter

    - Install Packages

    - Installing from git

    - Install a dev dependency

    - Show a dependency graph

    - Generate a lockfile

    - Install all dev dependencies

    - Uninstall everything

    - Use the shell

- Documentation

Installation
------------

Pipenv can be installed with Python 3.11 and above, including Python 3.15.

For most users, we recommend installing Pipenv using pip:

    pip install --user pipenv

Or, if you\'re using FreeBSD:

    pkg install py39-pipenv

Or, if you\'re using Gentoo:

    sudo emerge pipenv

Or, if you\'re using Void Linux:

    sudo xbps-install -S python3-pipenv

Alternatively, some users prefer to use Pipx:

    pipx install pipenv

Or, some users prefer to use Python pip module.


    python -m pip install pipenv

Refer to the documentation for latest instructions.

✨🍰✨

Features
----------

-   Enables truly deterministic builds, while easily specifying only
    what you want.
-   Generates and checks file hashes for locked dependencies.
-   Automatically install required Pythons, if pyenv or asdf is available.
-   Automatically finds your project home, recursively, by looking for a
    Pipfile.
- 

Top issues

Discussions

Latest release

Release v2026.11.0 v2026.11.0 2026-11-09
🤖 AI-Generated Changelog

 Added
- Added a new uv resolver backend as an alternative to the default pip-based resolver, providing faster dependency resolution

 Changed
- Vendored pip 26.3 with rebased Pipenv patches

 Fixed
- Fixed suppression of Safety warnings in quiet mode during pipenv scan, preserving stderr output appropriately
- Fixed VCS entries losing their environment markers when using --no-lock
- Fixed latent bugs identified by CodeQL code quality analysis

---

🔗 Full Changelog: https://github.com/pypa/pipenv/compare/v2026.10.6...v2026.11.0

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON