Skip to content

Virtual environment plugins

This uses virtual environments backed by the standard virtualenv tool.


The environment plugin name is virtual.

type = "virtual"
type = "virtual"


Option Default Description
system-packages false Whether or not to give the virtual environment access to the system site-packages directory
python The version of Python to find on your system and subsequently use to create the environment, defaulting to the HATCH_PYTHON environment variable, followed by the first Python executable found along your PATH, followed by the Python executable Hatch is running on. For more information, see the documentation.
env:HATCH_ENV_TYPE_VIRTUAL_PATH An explicit path to the virtual environment

Last update: August 4, 2022