:
Ensure you have a tool like pyenv installed and properly configured in your shell profile ( .bashrc , .zshrc , etc.). Step 2: Install the Required Python Version
A .python-version file contains exactly one line of text: the specific version number of Python required for a project (for example, 3.12.2 ). .python version
uv venv --python 3.13
In the Python ecosystem, ".python-version" refers to a configuration file used by version managers like and modern tools like to lock a project to a specific Python interpreter. The most useful feature of this file is automatic version switching . When you enter a directory containing a .python-version : Ensure you have a tool like pyenv
Setting up automated version switching takes less than a minute. Follow these steps using pyenv as the primary example. 1. Install the Desired Python Version
: A multi-language version manager that supports the .python-version standard via its Python plugin. The most useful feature of this file is
pyenv install 3.13.13
The .python-version file is a plain text file used by Python version managers to automatically switch between different Python environments based on your current project directory.
Should I help you set up pyenv or a specific environment manager to start using this file? What's New In Python 3.11 — Python 3.14.4 documentation