python-discovery

Python interpreter discovery

python-discovery Permissive license Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction,… (full text in the JSON record) Active ★ 13 v1.5.2 released 2026-08-12

Install

python-discovery on PyPI

pip

pip install python-discovery

uv

uv add python-discovery

poetry

poetry add python-discovery

Package facts

License	Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction,… (full text in the JSON record) (permissive)
Python support	supports the current Python release (>=3.8)
Install friction	low — pure-Python wheel
Runtime dependencies	1 — filelock
Maintenance	actively maintained — 1 days since the last release
Last repo commit	2026-08-12
First released	2026-02-25
Popularity	one of the top 1,000 most-downloaded packages on PyPI (30-day window, as of 2026-08-13)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-13)

Evidence: python_discovery-1.5.2-py3-none-any.whl

Keywords: discovery, interpreter, python

Development Status :: 5 - Production/StableIntended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseOperating System :: MacOS :: MacOS XOperating System :: Microsoft :: WindowsOperating System :: POSIXProgramming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Programming Language :: Python :: 3.15Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Programming Language :: Python :: Implementation :: CPythonTopic :: Software Development :: LibrariesTopic :: Utilities

About python-discovery

from the package's own PyPI description — quoted content, verbatim

`python-discovery`

PyPI (image) Supported Python versions (image) Downloads (image) check (image) Documentation Status (image)

What is python-discovery?

python-discovery is a library for discovering Python interpreters installed on your machine. You may have multiple Python versions from system packages, pyenv, mise, asdf, uv, or the Windows registry (PEP 514). This library finds the right one for you.

Give it a...

Read as markdown · JSON record · Source repository · Homepage · Docs

AI interpretation — verify before relying

AI-generated interpretation of the package facts above; every digit, version, license, or vulnerability id it cites is grounded in the facts already shown on this page

Discovers Python interpreters installed on your system across multiple sources (system packages, pyenv, mise, asdf, uv, Windows registry) and returns detailed metadata for a given version requirement, with disk-based caching for fast repeated lookups.

Active maintenance with a release just 1 day old. Single lightweight runtime dependency (filelock) and pure-Python wheel distribution keep install friction low. Supports Python 3.8 through 3.15.

MIT license (permissive) allows unrestricted use, modification, and distribution in commercial and private projects with minimal obligations.

Usage

from pathlib import Path
from python_discovery import DiskCache, get_interpreter

cache = DiskCache(root=Path("~/.cache/python-discovery").expanduser())
result = get_interpreter("python3.12", cache=cache)
if result:
    print(result.executable)  # /usr/bin/python3.12

Verdict: Production-ready library with active maintenance, no known vulnerabilities, and minimal dependencies. Solves a specific and useful problem—locating Python interpreters across multiple installation sources—with a clean API and broad platform support. MIT license poses no restrictions.

Needs verification

Whether caching behavior and cache invalidation strategy meet performance expectations for your use case
Completeness of interpreter discovery across all supported package managers on your specific platform

python interpreter discoveryfind python version installedpython version detectionmulti-version python locatorpython executable finderpyenv asdf interpreter searchpython version specifier resolver