Sometimes I download the python source code from github and don't know how to install all the dependencies. If there is no requirements.txt file I have to create it by hands.
The question is:
Given the python source code directory is it possible to create requirements.txt automatically from the import section?
- 7,766
- 8
- 46
- 61
- 16,880
- 10
- 27
- 33
-
39You can do it by running `pip freeze > requirements.txt` will save all your python libraries with current version into `requirements.txt` file – Shaikhul Jul 28 '15 at 18:36
-
18@Shaikhul but that doesn't help in the case where you don't have the dependencies installed because you've only just downloaded the package from GitHub... – jonrsharpe Jul 28 '15 at 18:58
-
18Please note: a) `pip freeze` will dump current versions of `all` the installed modules on that system irrespective of there usage in the current project. b) pip will only list modules that have been installed via pip – akskap Jan 17 '17 at 03:10
-
@akskap what are the non pip ways of installing modules? setup.py install? Will pipreqs ignore those? – sureshvv Sep 27 '21 at 07:47
21 Answers
You can use the following code to generate a requirements.txt file:
pip install pipreqs
pipreqs /path/to/project
more info related to pipreqs can be found here.
Sometimes you come across pip freeze, but this saves all packages in the environment including those that you don't use in your current project.
- 13,333
- 7
- 23
- 42
-
thanks. I've got `ubuntu@laptop ~/Desktop/MemNN-hyperopt $ pipreqs ./ /Library/Python/2.6/site-packages/requests/packages/urllib3/util/ssl_.py:90: InsecurePlatformWarning: A true SSLContext object is not available. This prevents urllib3 from configuring SSL appropriately and may cause certain SSL connections to fail. For more information, see https://urllib3.readthedocs.org/en/latest/security.html#insecureplatformwarning. InsecurePlatformWarning` is it ok? – Igor Barinov Jul 28 '15 at 18:40
-
To be honest I never encountered this before. It does seems caused because your python version can't reliably be used for SSL connections. There are some workarounds enlisted at https://github.com/pypa/pip/issues/2681, I also read that upgrading your python version might help. Perhaps some expert on this matter can give better advice? – DJanssens Jul 28 '15 at 18:50
-
1@IgorBarinov thats a Warning and won't create a problem to run `pipreqs`, I installed it on python 2.6 and got same warning but it does create a `requirements.txt` file, thanks @DJanssens – Shaikhul Jul 28 '15 at 19:29
-
2@Shaikhul if you got these warnings you will not have a full file, you will just get a part of requirements. You can check it on https://github.com/npow/MemNN/tree/hyperopt repo. I have only 'hyperopt == 0.0.2 numpy == 1.9.2 scikit_learn == 0.16.1 theano == 0.7.0' – Igor Barinov Jul 28 '15 at 19:59
-
-
1[that said](https://urllib3.readthedocs.org/en/latest/security.html#insecureplatformwarning) `it is strongly recommended to upgrade to a newer Python version` – Shaikhul Jul 28 '15 at 20:15
-
@IgorBarinov what requreiments were you expecting to get on the project github.com/npow/MemNN/tree/hyperopt ? I see only numpy, scikit, theano as external packages that were installed using pip, other ones are native – Bndr Oct 21 '15 at 09:35
-
1This doesn't work for Python 3.6, if the new print statement output formatting is uesd. – Anand C U Mar 16 '18 at 10:00
-
@AnandCU what happens ? I see in the project it does reference py3.6 https://github.com/bndr/pipreqs/search?utf8=%E2%9C%93&q=python3+&type= – AnneTheAgile Mar 23 '18 at 18:23
-
@AnandCU update; It looks like it is fixed now, but in the code, not yet a release; see this PR https://github.com/damnever/pigar/pull/40 – AnneTheAgile Mar 23 '18 at 19:35
-
8I used pipreqs and needed to specify the used charset in my scanned projectfolder - otherwise I received an error generated by pipreqs: `pipreqs --encoding utf-8` – squeezer44 Oct 09 '20 at 22:51
-
3
-
1Note: This will not include installed apps in your settings that are not explicitly imported in your views but nonetheless being used in the background. – chaudim Mar 19 '21 at 18:22
-
@chaudim Including, for example, the python module for your database driver. – Shadur Aug 23 '21 at 08:49
-
I have got the error `UnicodeDecodeError: 'charmap' codec can't decode byte 0x98 in position 1359: character maps to
`. Solution `pipreqs --encoding=utf8 path_to`, more here https://stackoverflow.com/a/51511050/9913319 – Rufat Nov 13 '21 at 04:28 -
These project seems good, but must be checked because in some cases give the wrong version of the used modules. It seems as if it checks the names of the required modules in files but shows the most current version available for install no the current used version that is really installed at the environment. – Luis Carlos Jan 02 '22 at 20:39
-
Important notice: this variant can be bad. Use virtualenv and pip3 freeze > requirements.txt. Let me explain: pipreqs only saves packages which are imported in project, not their dependencies. Sometimes package maintainer write requirement rule like this: "Jinja2>=2.10" (this is from `setup.py` of Flask 1.02 package). So the incompatible major version can be installed (in my example i got Jinja 3.1.0) and breaks everything. – Maxim Khokhryakov Apr 11 '22 at 20:43
-
7For anyone erroring, I recommend trying `pip3 freeze > requirements.txt` before asking a question. – baranskistad Aug 18 '17 at 15:39
-
4I execute `pip3 freeze > requirements.txt` and I'm surprised to not find some packages I am actually using such as `argparse` and `configparser`. Is it because they are part of Python core? I believe a better answer is to use `pipreqs` below because it will only list the requirements your project is using. – Alexis.Rolland Nov 03 '17 at 17:15
-
@Alexis.Rolland Yes, `argparse` and `configparser` is belong to Python3 standard library, so, what's wrong with `pip3 freeze`? I don't get your point. – damnever Nov 04 '17 at 04:00
-
64@damnever Ok thank you! `pip3 freeze` gives me the list of all the Python packages installed in my environment whereas `pipreqs` gives me all the ones actually used in my source code which is what I was looking for. Beside that, nothing's wrong with it. – Alexis.Rolland Nov 04 '17 at 04:22
-
2pipenv has serious issues, see this discussion: https://news.ycombinator.com/item?id=18612590 – Justin M. Keyes Jan 04 '19 at 14:53
-
@JustinM.Keyes There are some alternatives, such as https://github.com/sdispater/poetry, but I can not recommend them since I use other language more often :-D – damnever Jan 09 '19 at 06:24
-
8Piping into `requirements.txt` can be [quite a bad idea.](https://medium.com/@tomagee/pip-freeze-requirements-txt-considered-harmful-f0bce66cf895) – pfabri Mar 21 '19 at 19:42
-
Just created a requirements.txt file with pigars, don't recommend it. Didn't include django-corse-headers dependency which unabled me to even run the application. Good I didn't push it to repo – tikej Feb 10 '21 at 15:02
-
For python3: (I have both python 2 and 3 on my machine, where python2 is the default)
# install
pip3 install pipreqs
# Run in current directory
python3 -m pipreqs.pipreqs .
python2:
pip install pipreqs
python -m pipreqs.pipreqs .
To check your python version:
python --version
- 1,218
- 12
- 11
-
1Worked for me with a slight modifcation: `pip install pipreqs` and then `python -m pipreqs.pipreqs .` – Tirbo06 Sep 17 '21 at 11:29
-
2@Tirbo06 I added the python2 version as well, and the command to check which version of python is installed :) – Rea Haas Sep 19 '21 at 09:59
In my case, I use Anaconda, so running the following command from conda terminal inside my environment solved it, and created this requirements.txt file for me automatically:
conda list -e > requirements.txt
This was taken from this Github link pratos/condaenv.txt
If an error been seen, and you are using anaconda, try to use the .yml option:
conda env export > <environment-name>.yml
For other person to use the environment or if you are creating a new enviroment on another machine:
conda env create -f <environment-name>.yml
- 23
- 1
- 1
- 6
- 1,459
- 1
- 17
- 15
-
if you're not using a virtual environment, this will create an overly long requirements.txt file – SBFRF Jul 14 '19 at 14:28
-
3Does this actually work? Whenever I have tried this there are dependencies and syntax particulars that `pip install requirements.txt` rejects. – conner.xyz Jul 15 '19 at 20:33
-
I found some errors using the .txt, so just added the other option that worked with me too..."Using the .yml" mentioned above. – HassanSh__3571619 Mar 03 '20 at 23:50
To create a requirement Python module list, write this code in your terminal:
pip3 freeze > requirements.txt
Kinda mind-blowing how this simple task is so complicated in Python. Here is what I think is the best way to do it automatically.
You need two tools:
1.pipreqs
pip3 install pipreqs
pipreqs will go through your project and only install the packages that your project use. Instead of all the packages in your python environment as pip freeze would do.
But there's a problem with this approach. It does not install the sub-packages.
For example, your project uses pandas==1.3.2. pandas itself uses numpy==1.21.2 among other packages. But pipreqs itself does not write the sub-packages (i.e. numpy) in requirments.txt
This is where you need to combine pipreqs with the second tool.
pip3 install pip-tools
pip-tools will take the packages in requirements.in and generate the requirements.txt with all the sub-packages. For example, if you have
pandas==1.3.2 in requirements.in, pip-tools would generate
numpy==1.21.2 # via pandas in requirements.txt.
But you need to manually add the package in requirements.in. Which is prone to mistake and you might forget to do this once in a while.
This is where you can use the first tool.
But both the tools write to requirements.txt. So how do you fix it?
Use the --savepath for pipreqs to write in requirements.in instead of the default requirements.txt.
To do it in one command; just do
pipreqs --savepath=requirements.in & pip-compile
There you go. Now you don't need to worry about manually maintaining the packages and you're requirements.txt will have all the sub-packages so that your build is deterministic.
TL;DR
pip3 install pipreqspip3 install pip-tools
Use the following to build a deterministic requirements.txt
pipreqs --savepath=requirements.in && pip-compile
- 3,956
- 1
- 21
- 43
- 389
- 3
- 10
-
5It should be `pip install pip-tools` instead of `pip install pip-tool` – Shashwat Swain Feb 21 '22 at 11:20
Firstly, your project file must be a py file which is direct python file. If your file is in ipynb format, you can convert it to py type by using the line of code below:
jupyter nbconvert --to=python
Then, you need to install pipreqs library from cmd (terminal for mac).
pip install pipreqs
Now we can create txt file by using the code below. If you are in the same path with your file, you can just write ./ . Otherwise you need to give path of your file.
pipreqs ./
or
pipreqs /home/project/location
That will create a requirements.txt file for your project.
- 712
- 7
- 12
-
I get `No template sub-directory with name 'python' found in the following paths` – koppor Jun 08 '21 at 15:31
-
You can try uninstalling and installing nbconvert using: pip uninstall nbconvert pip install nbconvert @koppor – berkayln Jun 09 '21 at 07:03
I blindly followed the accepted answer of using pip3 freeze > requirements.txt
It generated a huge file that listed all the dependencies of the entire solution, which is not what I wanted.
So you need to figure out what sort of requirements.txt you are trying to generate.
If you need a requirements.txt file that has ALL the dependencies, then use the pip3
pip3 freeze > requirements.txt
However, if you want to generate a minimal requirements.txt that only lists the dependencies you need, then use the pipreqs package. Especially helpful if you have numerous requirements.txt files in per component level in the project and not a single file on the solution wide level.
pip install pipreqs
pipreqs [path to folder]
e.g. pipreqs .
pipreqs . --force --ignore=tests (Overwrites exisiting requirements.txt, ignores the tests directory)
- 1,510
- 1
- 24
- 31
-
If you don't to include subdirectories, you can add the --ignore
flag to your command – Francis Jun 17 '21 at 01:55 -
If you require Juptyer notebook support, you can see jltz2's answer below https://stackoverflow.com/a/68544207/1622880 – Francis Oct 24 '21 at 23:00
Make sure to run pip3 for python3.7.
pip3 freeze >> yourfile.txt
Before executing the above command make sure you have created a virtual environment.
python3:
pip3 install virtualenv
python3 -m venv <myenvname>
python2:
pip install virtualenv
virtualenv <myenvname>
After that put your source code in the directory. If you run the python file now, probably it won't launch if you are using non-native modules. You can install those modules by running pip3 install <module> or pip install <module>.
This will not affect you entire module list except the environment you are in.
Now you can execute the command at the top and now you have a requirements file which contains only the modules you installed in the virtual environment. Now you can run the command at the top.
I advise everyone to use environments as it makes things easier when it comes to stuff like this.
If Facing the same issue as mine i.e. not on the virtual environment and wants requirements.txt for a specific project or from the selected folder(includes children) and pipreqs is not supporting.
You can use :
import os
import sys
from fuzzywuzzy import fuzz
import subprocess
path = "C:/Users/Username/Desktop/DjangoProjects/restAPItest"
files = os.listdir(path)
pyfiles = []
for root, dirs, files in os.walk(path):
for file in files:
if file.endswith('.py'):
pyfiles.append(os.path.join(root, file))
stopWords = ['from', 'import',',','.']
importables = []
for file in pyfiles:
with open(file) as f:
content = f.readlines()
for line in content:
if "import" in line:
for sw in stopWords:
line = ' '.join(line.split(sw))
importables.append(line.strip().split(' ')[0])
importables = set(importables)
subprocess.call(f"pip freeze > {path}/requirements.txt", shell=True)
with open(path+'/requirements.txt') as req:
modules = req.readlines()
modules = {m.split('=')[0].lower() : m for m in modules}
notList = [''.join(i.split('_')) for i in sys.builtin_module_names]+['os']
new_requirements = []
for req_module in importables:
try :
new_requirements.append(modules[req_module])
except KeyError:
for k,v in modules.items():
if len(req_module)>1 and req_module not in notList:
if fuzz.partial_ratio(req_module,k) > 90:
new_requirements.append(modules[k])
new_requirements = [i for i in set(new_requirements)]
new_requirements
with open(path+'/requirements.txt','w') as req:
req.write(''.join(new_requirements))
P.S: It may have a few additional libraries as it checks on fuzzylogic.
- 1,749
- 15
- 20
best way for Python 3 is:
pip3 freeze > requirements.txt
it worked for me...
- 857
- 1
- 13
- 29
-
8Excuse me but how is your answer different to https://stackoverflow.com/a/33468993/5791355? – Taras Jan 08 '21 at 08:30
If you have installed many dependencies in your system and you need requirements.txt for a specific project, you can install first pipreqs:
$ pip install pipreqs
and execute the below command under the project folder.
$ pipreqs
This command will generate requirements.txt file for the particular project.
- 1,306
- 5
- 19
- 30
- 71
- 1
- 1
Simple Pythonic Way
To get a list of all the REQUIREMENTS in a standard requirements.txt file, you can use the following command.
pip freeze > requirements.txt
Now, this should automatically create a standard requirements file with all of the packages installed alongside their corresponding versions.
Pretty Print on Terminal
If you just want to get a pretty print on the terminal you can use the following approach.
pip list
This lists all of the installed packages, in a pretty print format.
Custom Dependency
If you have a project folder like say, a Github Repo, and you want to get a custom requirements.txt for project You can use the following Package.
https://pypi.org/project/pipreqs/ pipreqs
Usage
$ pipreqs /home/project/location
Successfully saved requirements file in /home/project/location/requirements.txt
Contents of requirements.txt
wheel==0.23.0
Yarg==0.1.9
docopt==0.6.2
- 359
- 3
- 14
Automatic requirements.txt updating approach
While developing a python application with requirements.txt we have several choices:
- Generate requirements.txt after development, when we want to deploy it. It is performed by
pip freeze > requirements.txtorpipreqsfor less messy result. - Add every module to requirements.txt manually after each install.
- Install manager that will handle requirements.txt updates for us.
There are many answers for the 1-st option, the 2-d option is self-explanatory, so I would like to describe the 3-d approach. There is a library called to-requirements.txt. To install it type this:
pip install to-requirements.txt # Pip install to requirements.txt
If you read the whole command at once you would see, what it does. After installing you should setup it. Run:
requirements-txt setup
It overrides the pip scripts so that each pip install or pip uninstall updates the requirements.txt file of your project automatically with required versions of packages. The overriding is made safely, so that after uninstalling this package the pip will behave ordinary.
And you could customize the way it works. For example, disable it globally and activate it only for the required directories, activate it only for git repositories, or allow / disallow to create requirements.txt file if it does not exist.
Links:
- 1,184
- 1
- 9
- 16
If you want to list only packages used inside a virtualenv use:
pip freeze -l > requirements.txt
- 1,967
- 2
- 16
- 34
-
1**-l, --local If in a virtualenv that has global access, do not output globally-installed packages.** Does exactly what I need. – rob Apr 25 '22 at 10:14
Not a complete solution, but may help to compile a shortlist on Linux.
grep --include='*.py' -rhPo '^\s*(from|import)\s+\w+' . | sed -r 's/\s*(import|from)\s+//' | sort -u > requirements.txt
- 4,983
- 5
- 24
- 22
I created this bash command.
for l in $(pip freeze); do p=$(echo "$l" | cut -d'=' -f1); f=$(find . -type f -exec grep "$p" {} \; | grep 'import'); [[ ! -z "$f" ]] && echo "$l" ; done;
- 1,265
- 6
- 21
- 27
- 61
- 1
Or if your are using a something like virtualenv you can just run this command to generate a requirements.txt
$ ./.venv/bin/pip freeze > requirements.txt
- 133
- 2
- 10
-
tried creating a docker image with these requirements, and it failed (which was not the case with the pipreqs solution). – Xema Mar 22 '22 at 10:51
-
I'm not sure why it happened although I use this all the time while creating docker image. If you can provide the error here I might be able to explain it. – Sanaf Mar 22 '22 at 17:48
@Francis has it right - https://stackoverflow.com/a/65728461/1021819
But just to add:
With additional support for Jupyter notebooks - i.e. .ipynb files - you can now use https://pypi.org/project/pipreqsnb (same syntax as pipreqs):
pip install pipreqsnb
pipreqs .
[I am not an author]
- 6,105
- 7
- 54
- 98
Using pip freeze > requirements.txt is a bad way to create the requirements file! It can serve as a temporary solution for your problem but when managing requirements for python project it is best to do it manually.
A simple search for "import" or "from x import" will give you the list of all dependencies that need to be installed (nothing extra).
The problem with pip freeze it that it simply dumps all installed packages with strict versions, every dependency has its own dependencies and they are included in the dump.
For example, you have lib==1.0 installed, that needs sub-lib==0.5, if you use pip freeze you'll get both, but later when you wish to update the version of lib to 2.0, most likely you'll get conflicts since lib v2.0 now uses sub-lib v1.0 not v0.5 that you require... This gets complex fast for multiple dependencies.
We got into those problems in a couple of projects, since then I created an automated script to clean pip freeze's dumps, it is safe (comments unneeded dependencies) and works great.
- 1,170
- 11
- 13
To help solve this problem, always run requirements.txt on only local packages. By local packages I mean packages that are only in your project folder. To do this do: Pip freeze —local > requirements.txt
Not pip freeze > requirements.txt. Note that it’s double underscore before local.
However installing pipreqs helps too. Pip install pipreqs.
The perfect solution though is to have a pipfile. The pipfile updates on its own whenever you install a new local package. It also has a pipfile.lock similar to package.json in JavaScript. To do this always install your packages with pipenv not pip. So we do pipenv
- 1
- 1