• Repository

Meta

• Maintainer: Bernát Gábor

Meta

• License: MIT License (Permission is hereby granted, free of charge, to any person obtaining a)
• Tags discovery , interpreter , python
• Requires: Python >=3.8
• Provides-Extra: docs , testing

Classifiers

• Development Status
  • 5 - Production/Stable
• Intended Audience
  • Developers
• License
  • OSI Approved :: MIT License
• Operating System
  • MacOS :: MacOS X
  • Microsoft :: Windows
  • POSIX
• Programming Language
  • Python :: 3 :: Only
  • Python :: 3.8
  • Python :: 3.9
  • Python :: 3.10
  • Python :: 3.11
  • Python :: 3.12
  • Python :: 3.13
  • Python :: 3.14
  • Python :: Implementation :: CPython
• Topic
  • Software Development :: Libraries
  • Utilities

python-discovery

👁 PyPI
👁 Supported Python versions
👁 Downloads
👁 check
👁 Documentation Status

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 requirement like python3.12 or >=3.11,<3.13, and it searches all known locations, verifies each candidate, and returns detailed metadata about the match. Results are cached to disk so repeated lookups are fast.

Usage

frompathlibimport Path

frompython_discoveryimport DiskCache, get_interpreter

cache = DiskCache(root=Path("~/.cache/python-discovery").expanduser())
result = get_interpreter("python3.12", cache=cache)
if result is not None:
 print(result.executable) # /usr/bin/python3.12
 print(result.implementation) # CPython
 print(result.version_info[:3]) # (3, 12, 1)

The get_interpreter() function accepts various specification formats:

• Absolute path: /usr/bin/python3.12
• Version: 3.12
• Implementation prefix: cpython3.12
• Version specifier: >=3.10, >=3.11,<3.13

Documentation

Full documentation is available at python-discovery.readthedocs.io

Verified details

These details have been verified by PyPI

Project links

• Changelog
• Homepage
• Source
• Tracker

GitHub Statistics

Maintainers

👁 Avatar for gaborbernat from gravatar.com
gaborbernat

Unverified details

These details have not been verified by PyPI

Project links

• Documentation

• Download URL: python_discovery-1.4.2.tar.gz
• Upload date: Jun 11, 2026
• Size: 70.3 kB
• Tags: Source
• Uploaded using Trusted Publishing? Yes
• Uploaded via: twine/6.1.0 CPython/3.13.13

Hashes for python_discovery-1.4.2.tar.gz

Algorithm	Hash digest
SHA256	8f3746c4b4968d22afbb97d36e1a0e5b66e6c0f297290f2e95f05b9b8bf18690
MD5	51d70fd912f321b59efd8635b1c6f350
BLAKE2b-256	0b1acbbaf13b730abb0a16b964d984e19f2fe520c21a4dc664051359a3f5a9e7

See more details on using hashes here.

• Download URL: python_discovery-1.4.2-py3-none-any.whl
• Upload date: Jun 11, 2026
• Size: 33.9 kB
• Tags: Python 3
• Uploaded using Trusted Publishing? Yes
• Uploaded via: twine/6.1.0 CPython/3.13.13

Hashes for python_discovery-1.4.2-py3-none-any.whl

Algorithm	Hash digest
SHA256	475803f53b7b2ed6e490e27373f9d8340f7d2eebf9acdaf645d7d714c97bb500
MD5	2e032aa50cab4d7cd911d340f341072b
BLAKE2b-256	1a82a70006589557f267f15bd384c0642ad49f0d97b690c3a05b166b9dcbad3b

See more details on using hashes here.