Skip to main content
Now that Python and VS Code are set up, the next step is to create a virtual environment for your project. Virtual environments are essential for isolating project dependencies and preventing version conflicts.

​
Understanding Virtual Environments

Imagine you have two projects:
  • Project One requires FastAPI version 1.2.1.
  • Project Two requires FastAPI version 2.4.3.
If FastAPI were installed globally and you upgraded to version 2.4.3 for Project Two, Project One might break if version 2.4.3 lacks backward compatibility with version 1.2.1. Virtual environments solve this problem by allowing you to install packages locally, ensuring that each project has its own separate dependencies.
Using virtual environments ensures that different projects can use different versions of the same package without conflicts. This isolation is crucial for maintaining stability across your projects.
For example:
  • In Project One, you can create a virtual environment (e.g., named “venv1”) and install FastAPI version 1.2.1.
  • In Project Two, create another virtual environment (e.g., “venv2”) and install FastAPI version 2.4.3.
This method keeps your projects separate and avoids any unintended version conflicts.
The image illustrates the structure of Python virtual environments for two projects, each with its own virtual environment and version of FastAPI.
Each virtual environment is completely isolated, allowing you to work on multiple projects simultaneously without worrying about shared dependencies interfering with each other.

​
Creating Your First Virtual Environment

With this understanding in hand, you’re ready to create your first virtual environment and manage your project’s dependencies. Follow the steps below to get started:
  1. Open your project folder in VS Code.
  2. Open the integrated terminal.
  3. Run the following command to create a virtual environment (replace “venv” with your preferred name): 
    python -m venv venv
  4. Activate the virtual environment:
    • On Windows: 
      venv\Scripts\activate
    • On macOS and Linux: 
      source venv/bin/activate
  5. Once activated, you can install packages like FastAPI without affecting the global Python environment.
Moving forward, always ensure your virtual environment is activated before installing new packages or running your project. This practice helps maintain consistency and avoids potential conflicts. Happy coding!

Watch Video