Last modified: May 28, 2025 By Alexander Williams
How to Install Python Packages with Requirements.txt
Managing Python dependencies is easy with requirements.txt. This file lists all packages your project needs. Learn how to use it.
Table Of Contents
What is requirements.txt?
A requirements.txt file contains a list of Python packages. Each package has a version number. This helps recreate the same environment.
It ensures everyone uses the same dependencies. This avoids conflicts and errors. It's a best practice for Python projects.
Creating a requirements.txt File
First, install the packages you need. Use pip install
for each package. Then, generate the file.
pip install package1 package2 package3
pip freeze > requirements.txt
This creates requirements.txt in your project folder. Open it to see the installed packages.
Installing Packages from requirements.txt
Use pip install -r
to install all listed packages. Run this command in your project directory.
pip install -r requirements.txt
This installs all dependencies. It ensures your project runs smoothly.
Example of requirements.txt
Here’s an example of a requirements.txt file:
numpy==1.21.0
pandas==1.3.0
requests==2.26.0
Each line specifies a package and version. This ensures consistency across setups.
Updating requirements.txt
Update the file when you add new packages. Use pip freeze
again to refresh it.
pip freeze > requirements.txt
This overwrites the old file. Always check the changes before committing.
Handling Different Environments
Use separate files for different environments. For example, dev-requirements.txt for development.
This keeps production clean. Only necessary packages are installed there.
Common Issues and Fixes
Sometimes, installation fails. Check these common issues:
1. Wrong Python version: Ensure compatibility.
2. Network issues: Check your internet connection.
3. Package not found: Verify the package name.
For more help, check our guide on How to Install Tkinter in Python.
Using Virtual Environments
Virtual environments isolate dependencies. Create one using python -m venv
.
python -m venv myenv
source myenv/bin/activate # On Linux/Mac
myenv\Scripts\activate # On Windows
This avoids conflicts between projects. Always activate it before installing packages.
Advanced Usage
You can specify versions flexibly. For example:
package>=1.0.0 # Minimum version
package<=2.0.0 # Maximum version
package~=1.2.0 # Compatible release
This gives more control over dependencies. Learn more in our Install Paramiko in Python Easily guide.
Conclusion
Using requirements.txt simplifies dependency management. It ensures consistency across setups.
Always update it when adding new packages. Use virtual environments for isolation. For more tips, see Install Python Package from Local Directory.
Now you can manage Python packages like a pro!