Back to Fastapi

Virtual Environments { #virtual-environments }

docs/en/docs/virtual-environments.md

0.140.01.1 KB
Original Source

Virtual Environments { #virtual-environments }

When you work with Python projects, you should use a virtual environment to isolate the packages installed for each project.

For FastAPI projects, I recommend using uv to manage the project, its dependencies, and its virtual environment.

Create a Project { #create-a-project }

Install uv using the official installation guide, and then create a project:

<div class="termy">
console
$ uv init awesome-project --bare
$ cd awesome-project
$ uv add "fastapi[standard]"
</div>

uv creates a virtual environment for the project automatically. You don't need to create or activate one yourself.

Run commands inside the project environment with uv run, for example:

<div class="termy">
console
$ uv run fastapi dev
</div>

Learn More { #learn-more }

Read the Virtual Environments guide to learn how virtual environments work underneath, including activation and the alternative python -m venv and pip workflow.