bashANYbootstrapprojectvenv
bash
mkdir myapp && cd myapp && python -m venv .venvA common project-start sequence.
Python venv Project Setup Cheat Sheet
Project-level setup patterns for Python virtual environments, pyproject.toml, editable installs, dev tools, and team onboarding.
Export
Copy the compact sheet, download it, or print it.
Download
`D` dense toggle · `C` copy all
Project bootstrap
Create a local environment and prepare a project for work.
gitignoreANYgitignorevenvproject
gitignore
.venv/
venv/
__pycache__/
*.pyc
You normally commit dependency files, not the environment directory itself.
bashANYtoolingblackruffpytest
bash
python -m pip install black ruff pytestA typical local developer-tool bootstrap step.
pyproject.toml patterns
Use modern Python project metadata and local installs with venv.
tomlANYpyprojecttomlpackaging
toml
[build-system]
requires = ["setuptools>=68", "wheel"]
build-backend = "setuptools.build_meta"
[project]
name = "myapp"
version = "0.1.0"
dependencies = [
"requests>=2.31",
]
A starting point for modern packaging metadata and editable installs.
Install project editable from pyproject
Install the current project into the venv in editable mode.
bashANYeditablepyprojectdevelopment
bash
python -m pip install -e .Useful for app and library development using modern metadata.
bashANYeditableextrasdev
bash
python -m pip install -e ".[dev,test]"Useful when your project defines optional dependency groups for contributors.
Team onboarding and automation
Make local setup fast and consistent for teammates.
markdownANYreadmeonboardingsetup
markdown
```bash
python -m venv .venv
source .venv/bin/activate
python -m pip install -U pip setuptools wheel
python -m pip install -r requirements.txt
```
A good onboarding pattern for repository documentation.
makefileANYmakefilesetupautomation
makefile
setup:
python -m venv .venv
. .venv/bin/activate && python -m pip install -U pip setuptools wheel
. .venv/bin/activate && python -m pip install -r requirements.txt
A small quality-of-life improvement that helps teams onboard quickly.
bashANYdirenvautomationshell
bash
layout python python3
An optional workflow for automatic environment handling in supported shells.
More in Python venv
Python venv Troubleshooting Cheat Sheet
Diagnose activation problems, broken pip, wrong interpreter selection, PATH confusion, and environment drift in Python virtual environments.
Python venv + pip Cheat Sheet
Package installation, requirements, editable installs, wheel workflows, and dependency troubleshooting inside Python virtual environments.
Python venv Cheat Sheet
Comprehensive Python venv reference covering creation, activation, pip usage, requirements, inspection, and recovery workflows.