{"id":9183,"library":"pip-chill","title":"pip-chill","description":"pip-chill is a command-line utility that extends `pip freeze` by listing only the Python packages that were directly installed by the user, excluding their transitive dependencies. This helps create cleaner `requirements.txt` files. The current version is 1.0.5, and it has a moderate release cadence with improvements and bug fixes.","status":"active","version":"1.0.5","language":"en","source_language":"en","source_url":"https://github.com/rbanffy/pip-chill","tags":["cli","package management","pip","requirements"],"install":[{"cmd":"pip install pip-chill","lang":"bash","label":"Install latest version"}],"dependencies":[],"imports":[],"quickstart":{"code":"# List directly installed packages (excluding dependencies):\npip-chill\n\n# List all installed packages (like pip freeze):\npip-chill --no-chill\n\n# List all installed packages, including direct and indirect ones:\npip-chill --all\n\n# Include editable packages:\npip-chill --editable\n","lang":"bash","description":"To use pip-chill, simply run it from your terminal within a Python environment. The default output lists only top-level, directly installed packages. Options like `--no-chill` or `--all` can be used to display all installed packages, similar to `pip freeze`."},"warnings":[{"fix":"Upgrade your Python environment to 3.10 or newer. Alternatively, to use `pip-chill` with older Python versions (3.7-3.9), install an earlier compatible version, e.g., `pip install 'pip-chill<1.0.5'`.","message":"Starting with version 1.0.5, `pip-chill` explicitly requires Python 3.10 or newer. If you are on an older Python version (e.g., 3.9 or earlier), you will encounter installation errors or runtime issues.","severity":"breaking","affected_versions":"1.0.5+"},{"fix":"If programmatic execution is required, use `subprocess.run(['pip-chill', '...',])` to invoke the CLI tool from within your Python script.","message":"`pip-chill` is designed as a command-line interface (CLI) tool and does not expose a public Python API for programmatic `import`. Attempts to `import pip_chill` will not work as expected or will lead to `ModuleNotFoundError`.","severity":"gotcha","affected_versions":"All versions"},{"fix":"To view all installed packages, including transitive dependencies, use `pip-chill --no-chill` (which behaves like `pip freeze`) or `pip-chill --all`.","message":"By default, `pip-chill` lists only the packages you explicitly installed, filtering out their transitive dependencies. This differs from `pip freeze` which lists all installed packages. Users often misunderstand why some installed packages are 'missing' from `pip-chill`'s default output.","severity":"gotcha","affected_versions":"All versions"}],"env_vars":null,"last_verified":"2026-04-16T00:00:00.000Z","next_check":"2026-07-15T00:00:00.000Z","problems":[{"fix":"Ensure `pip-chill` is installed in your active Python environment by running `pip install pip-chill`.","cause":"`pip-chill` is not installed in your current environment or its installation directory is not in your system's PATH.","error":"pip-chill: command not found"},{"fix":"Upgrade your Python environment to version 3.10 or newer. If upgrading Python is not an option, install an older version of `pip-chill` that supports your Python version, for example: `pip install 'pip-chill<1.0.5'`.","cause":"The Python interpreter being used is older than the minimum requirement (Python 3.10) for the latest `pip-chill` version.","error":"ERROR: pip-chill requires Python >=3.10, but you have Python 3.9.12."},{"fix":"To list all installed packages, including both direct and transitive dependencies, use `pip-chill --no-chill` or `pip-chill --all`.","cause":"`requests` is likely a dependency of another package you installed directly. By default, `pip-chill` filters out transitive dependencies.","error":"My package 'requests' is installed, but `pip-chill` doesn't list it directly!"}]}