How do I create a Python virtual environment?

Navigate to your project directory and run python3 -m venv .venv . This creates a .venv folder containing an isolated Python interpreter and pip. Activate it with source .venv/bin/activate on Linux/macOS or .venv\Scripts\activate on Windows.

What is the difference between venv and pip?

venv creates the isolated environment (a folder with its own Python interpreter), while pip installs packages into whichever environment is currently active. You activate a venv first, then use pip to install project-specific dependencies inside it.

Can I rename a virtual environment folder?

No. Activation scripts and executable shebangs hardcode the absolute path to the environment folder, so renaming it with mv breaks them. Instead run pip freeze > requirements.txt , delete the old folder, create a new one with python3 -m venv new_name , and reinstall with pip install -r requirements.txt .

How do I delete a virtual environment?

Deactivate it first with deactivate , then remove its directory with rm -rf .venv . Because all dependencies live inside that one folder, deleting it removes the environment completely with no leftover system files.

What Is a Python Virtual Environment?

A Python virtual environment is an isolated, per-project folder that holds its own Python interpreter and installed packages, so dependencies for one project never conflict with another or with your global system Python.

If you have ever tried to run two Python projects that required different versions of the same library, you already know the pain of dependency conflicts.

The solution is simple: virtual environments. A virtual environment is a lightweight, isolated folder where you can install Python packages specifically for one project, without affecting your global system Python installation or breaking any of your other projects.

Using isolated environments helps you:

Prevent conflicts: Install exactly the versions you need for one project without breaking another.
Collaborate cleanly: Share your requirements.txt so anyone else can recreate the exact same setup.
Clean up safely: Because all dependencies are stored in one local folder, you can simply delete it when you’re done. No lingering junk on your system.

Using venv to Create an Isolated Python Environment

Using virtual environments is good practice, especially as projects grow in complexity and require different libraries that may not be compatible. The standard-library module venv allows each project to have its customised environment.

The venv module creates a virtual environment: a folder containing scripts and a link to the Python interpreter. Virtual environments offer two main benefits:

You can install project-specific libraries in isolation for better control.
When sharing your project, use “pip freeze > requirements.txt” to create a list of necessary libraries, keeping your environment clean.

Conclusion

🔒 Subscribe to keep reading.

References

🔒 Subscribe to keep reading.

You've hit a Deep Dive tutorial.

I spend dozens of hours researching, coding, and breaking things to write these guides. This content is free, but reserved for my subscriber community. Drop your email below to unlock this guide (and all past/future deep dives):

Already a subscriber? Use the magic link from your last newsletter, or reset your password.

New subscribers get an inbox mail: Set a password to unlock articles. The form does not log you in — use the same email afterwards.

Python Virtual Environments

📚 This post is part of the "Python Projects & Utilities" series

What Is a Python Virtual Environment?

Using venv to Create an Isolated Python Environment

Conclusion

References

References

Citation

Python Virtual Environments

📚 This post is part of the "Python Projects & Utilities" series

What Is a Python Virtual Environment?

Using venv to Create an Isolated Python Environment

Conclusion

References

You're in

References

Citation