Termhint Get Termhint

Coming from pyenv

A pyenv alternative that doesn't compile Python

Last checked 17 November 2026

In short: pyenv builds most Python versions from source on your Mac, so it needs a compiler and a set of Homebrew libraries first. Termhint installs prebuilt CPython from python-build-standalone, checks each download's checksum and GitHub attestation, and switches versions from the .python-version files you already have. It is a paid Mac app that also manages Node, Ruby, Go, Java, Xcode and more (all languages). If you need PyPy, several Pythons active at once, or your own build flags, keep pyenv.

How pyenv works

From pyenv's README and its wiki (suggested build environment) on 17 November 2026.

What changes with Termhint

pyenvTermhint
InstallDownloads the source and compiles itDownloads a prebuilt CPython from python-build-standalone; nothing is compiled
Before the first installXcode Command Line Tools and Homebrew librariesNothing
How the version is chosenShims on PATHNo shims: the shell puts the folder's version first on PATH as you change folders
Version files.python-version (several versions allowed).python-version (first version used), .tool-versions
DistributionsCPython, PyPy, Stackless, Jython and moreCPython
Virtual environmentsNot managed (plugin available)Not created or managed; the prompt can show the active one
PlatformsmacOS, Linux; Windows through WSL or the pyenv-win forkmacOS 14+ on Apple silicon
PriceFree, open sourcePaid after a 7-day trial

pyenv column: pyenv README, 17 November 2026.

Your .python-version files keep working

Termhint walks up from the current folder and uses the nearest .python-version, or the python line of a .tool-versions. It reads the first version in the file and skips comments. A prefix such as 3.13 means the newest 3.13 you installed. The file is read as data and never run.

$ cat .python-version
# for the API
3.12.4
3.11
$ termhint runtime current
python 3.12.4  not installed  (/Users/you/api/.python-version)

If a folder asks for a Python you don't have, the shell prints one line with the install command; nothing installs on cd. Both zsh and bash switch.

The pyenv commands you know

pyenvTermhint
pyenv install 3.13termhint runtime install python 3.13
pyenv install -ltermhint runtime list-remote python
pyenv versionstermhint runtime list python
pyenv local 3.12termhint runtime use python 3.12 (writes .tool-versions)
pyenv global 3.13termhint runtime use -g python 3.13
pyenv shell 3.11export TERMHINT_PYTHON_VERSION=3.11
pyenv exec python script.pytermhint runtime exec python@3.12 -- python3 script.py
pyenv uninstall 3.11.9termhint runtime uninstall python 3.11.9

Editors and GUI apps can point at ~/.local/share/termhint/runtimes/python/default.

Virtual environments

Termhint does not create or manage virtual environments. Make them the usual way, for example python3 -m venv .venv with the Python that Termhint installed. If you use a Termhint prompt theme, the prompt can show the active environment's name (termhint settings set prompt.venv.on on, on by default; see prompt themes).

Leaving pyenv

termhint runtime migrate pyenv --dry-run   # the plan: versions, pip tools, lines to turn off
termhint runtime migrate pyenv             # do it
termhint runtime migrate --undo            # turn pyenv's lines back on, byte for byte
  1. Each Python version you have in pyenv is downloaded again as a prebuilt, checked build. Nothing is copied from pyenv's folders.
  2. pyenv's global version becomes Termhint's default.
  3. Tools you installed with pip that have commands are reinstalled into the matching Termhint version with python3 -m pip install.
  4. pyenv's lines in ~/.zshrc, ~/.zprofile, ~/.bash_profile, ~/.bashrc and ~/.profile are backed up, then turned off with #termhint-off# in front.
  5. Removing pyenv is a separate choice (--remove): brew uninstall if Homebrew installed it, and its folders go to the Trash, only once every version installed and every tool moved.

A version pyenv has that python-build-standalone doesn't publish, such as a PyPy build, is not installed, and pyenv stays on if its default can't be installed. The same steps are a button in Settings → Runtimes → Other Managers.

Keep pyenv if…

What it costs

Every feature works for 7 days with no account and no card. After that, a one-time license: $11.99 for 1 Mac, $19.99 for 3, $29.99 for 5 (pricing). The same license covers Node and the other languages, autocomplete and prompt themes. Python versions you installed keep working if the license lapses.

Download for Mac See every language

Termhint is not affiliated with pyenv, python-build-standalone or the Python Software Foundation.