Apps
Poetry Cache
Poetry keeps two main disk caches: repository metadata in its cache directory and downloaded distribution artifacts such as wheel files and source tarballs in its artifacts directory. Those files speed up dependency resolution and repeated installs, but stale index responses, corrupted wheel archives, or partially downloaded sdists can cause solver mismatches and install failures; Kudu removes the cached metadata and package artifacts while leaving Poetry-managed virtual environments, projects, settings, and credentials alone.
Why it matters
Why clean Poetry Cache?
- Stale repository metadata can make Poetry resolve against outdated package versions, so you keep seeing version conflicts or 'could not find a matching version' until the cache is refreshed
- A corrupted wheel archive in the artifacts cache causes repeat install failures with checksum, unzip, or 'invalid wheel' errors because Poetry keeps reusing the same bad file
- Interrupted or partial source tarball downloads lead to build failures during dependency installation, often showing up as extraction errors or missing files in the package source
- Large cached wheels for multiple Python versions and platforms accumulate over time, so the pypoetry cache grows into gigabytes even when old projects are no longer installed
- Cached metadata from a previous state of a package index or mirror can keep Poetry talking to package versions that have been removed or replaced, which shows up as inconsistent lock or install behavior across machines
- Repeated retries against a bad cached artifact slow down installs because Poetry validates and reuses the same broken download before fetching a clean copy
- If Poetry's cache metadata is backed by SQLite, page fragmentation can waste disk space and slow lookups; VACUUM rewrites the database without deleting rows, while clearing the cache forces fresh metadata to be rebuilt
What gets cleaned
Cache paths Kudu targets
Windows
%LocalAppData%/pypoetry/Cache/cache |
%LocalAppData%/pypoetry/Cache/artifacts |
macOS
~/Library/Caches/pypoetry/cache |
~/Library/Caches/pypoetry/artifacts |
Linux
~/.cache/pypoetry/cache |
~/.cache/pypoetry/artifacts |
Frequently asked
Common questions about Poetry Cache
Related cleaners
Free & open source
Download Kudu and reclaim your disk space.
Available on Windows, macOS, and Linux. No account required, no feature gates, no telemetry without consent. All cleaning targets are open source and community-auditable.