Virtual Environments¶

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

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

Create a Project¶

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

$ uv init awesome-project --bare
$ cd awesome-project
$ uv add sqlmodel

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:

$ uv run python app.py

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.