pip Cache How to Clear It on Windows

AM tank — Wed, 07 Oct 2026 15:56:32 +0000

You can clear pip's cache on Windows with py -m pip cache purge after checking its location and size. This removes cached downloads and wheels, not packages already installed in your Python environments. If you only need to remove a particular cached wheel, use a targeted removal instead of purging everything.

Inspect the cache from the Python you use

Open Start > Command Prompt under your normal development account. These steps assume Python and pip are installed and the py command is available. Run:

py -m pip --version
py -m pip cache dir
py -m pip cache info

Keep the output so you know which installation and cache you inspected. The directory command reports the configured cache; the information command reports its contents and size. They help you decide whether cache cleanup is relevant before any deletion.

The usual Windows cache path is %LocalAppData%\pip\Cache, but do not assume that default matches your setup. Paste the path returned by the command into File Explorer to inspect the folder. Note the free space on its drive in File Explorer > This PC.

If you normally use python -m pip inside an activated virtual environment, use that same prefix for every command here. If neither py nor python identifies the Python you use, stop and locate that installation rather than running whichever pip happens to be found first.

The pip cache command reference lists the inspection and maintenance commands. Keep the interpreter prefix consistent throughout this task.

Choose a targeted removal or a full purge

Close or finish running pip installations before deleting cache entries. Your choice should follow the problem you measured: one unwanted cached build and a large collection of reusable downloads are different situations.

Remove cached wheels for one package

For a specific package, first inspect matching wheel entries. This example uses setuptools; substitute the package you actually intend to inspect:

py -m pip cache list setuptools
py -m pip cache remove setuptools

Removal has no built-in undo. It removes matching cached wheels, so a later installation may need to download or build the package again. Existing installed packages remain separate from these cached copies. Cancel your plan before the second command if you need to retain those cached files.

Targeted wheel removal does not clear pip's HTTP cache. If the remaining size is mostly HTTP data, deleting wheels for one package will not recover all of it. Avoid using a broad wildcard just to make the reported removal count larger.

Purge pip's reusable cache

To remove all wheel and HTTP cache files managed by this operation, run:

py -m pip cache purge

There is no built-in rollback, and these command-line deletions do not use the normal Recycle Bin workflow. Future installations may have to download files or rebuild wheels. Before purging, make sure required package sources and credentials are available; postpone it if you need those cached files for upcoming work without reliable network access.

Pip does not provide a restore command for the exact deleted cache. It can create new entries through later installation activity, which is different from recovering the old files. Do not reinstall your environments simply to refill the cache.

Check what changed

Run the same inspection commands again:

py -m pip cache dir
py -m pip cache info

Compare the cache size and the drive's free space with the values you recorded. Use the command result and actual storage figures, not an assumed number of gigabytes that cleanup should recover.

A small remaining folder or a quickly returning cache does not necessarily indicate an error. Later downloads can populate it again. When judging the result, avoid installing packages at the same time as measuring reclaimed space.

If a purge reports an error, save the message and examine the path before doing anything broader. A permissions problem is not permission to delete a whole user profile or change ownership of every AppData folder. Confirm the account and stop concurrent installs first.

Understand wheels and HTTP responses

Pip caches HTTP responses and reusable locally built wheels. A wheel is a package distribution used during installation; a cached copy is separate from the copy installed into an environment.

The pip caching guide explains both categories and their different removal behavior. The internal directory structure can change across pip versions, which is another reason to use pip's own commands rather than picking unfamiliar subfolders to delete.

Do not confuse the cache with project code, datasets, model files, or a virtual environment. Those can be large too, but they have different owners and recovery requirements. Seeing Python-related names is not enough to establish that a folder is disposable pip cache.

For the same reason, this procedure does not clean Conda's package cache or remove unused environments. If you use more than one package manager, identify which one owns the space you measured.

Multiple environments do not always mean multiple caches

Check cache dir using the interpreter associated with each environment you want to investigate. Two environments can report the same cache directory. In that case, purging through both does not produce two independent sets of savings.

Conversely, a configured cache path can differ between setups. Record the path before each operation, and do not treat a successful cleanup for one Python installation as proof that every development tool's cache is empty.

Keep environment removal outside this task. Deleting an environment removes its installed packages and creates a reconstruction problem; clearing pip cache leaves those installed packages in place. Preserve project requirements and other dependency records regardless of your cleanup choice.

For a wider view of system-drive usage, the Windows cleanup guide offers other categories to inspect. If you also use JavaScript tools, the npm cache guide covers their separate commands.

Keep caching unless you have a reason to change it

Pip's --no-cache-dir option disables caching for an operation. It is not required to clear existing cached files, and routinely disabling caching can cause repeated downloads and builds.

Decide based on your workflow: a one-time purge can recover space now, while retaining caching can reduce repeated work later. Do not add cache-disabling flags to every project just because one cleanup was useful.

If the cache keeps becoming large, compare its measured growth with other Python storage before setting a schedule. An installed environment or a dataset may be the larger recurring cost, and purging pip cannot recover that unrelated space.

Reviewing Python caches with AiCleanDisk Pro

I'm the developer of AiCleanDisk Pro. It includes pip cache in its auto-clean items, with developer items behind Show all items. Each item shows a risk level and asks for confirmation before cleaning. System-drive scanning and auto clean, except AI auto-clean, are free; other-drive scanning, AI analysis, AI auto-clean items, and folder moving require a license, paid once without automatic renewal. On my own machine, overall cleaning reclaimed about 14 GB and folder migration freed about 80 GB on C:, mostly caches, Temp and installed software; these are whole-machine results, not savings from pip cache alone or a guarantee for another PC.

DEV Community: AM tank