---
id: python-discovery
version: "1.5.2"
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)
license_treatment: permissive
maintenance: active
---

# python-discovery — Python interpreter discovery

License: permissive · Maintenance: active · Popularity: top 1,000 on PyPI

## Install

pip install python-discovery
uv add python-discovery
poetry add python-discovery

## Description

# [`python-discovery`](https://python-discovery.readthedocs.io/en/latest/)

[![PyPI](https://img.shields.io/pypi/v/python-discovery?style=flat-square)](https://pypi.org/project/python-discovery/)
[![Supported Python versions](https://img.shields.io/pypi/pyversions/python-discovery.svg)](https://pypi.org/project/python-discovery/)
[![Downloads](https://static.pepy.tech/badge/python-discovery/month)](https://pepy.tech/project/python-discovery)
[![check](https://github.com/tox-dev/python-discovery/actions/workflows/check.yaml/badge.svg)](https://github.com/tox-dev/python-discovery/actions/workflows/check.yaml)
[![Documentation Status](https://readthedocs.org/projects/python-discovery/badge/?version=latest)](https://python-discovery.readthedocs.io/en/latest/?badge=latest)

## 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](https://github.com/pyenv/pyenv), [mise](https://mise.jdx.dev/),
[asdf](https://asdf-vm.com/), [uv](https://docs.astral.sh/uv/), or the Windows registry (PEP 514). This library finds
the right one for you.

Give it a...

## AI interpretation — verify before relying

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.

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.

[View on SkillFed](https://skillfed.io/packages/python-discovery) · [View on PyPI](https://pypi.org/project/python-discovery/)