755

I've installed a library using the command

pip install git+git://github.com/mozilla/elasticutils.git

which installs it directly from a Github repository. This works fine and I want to have that dependency in my requirements.txt. I've looked at other tickets like this but that didn't solve my problem. If I put something like

-f git+git://github.com/mozilla/elasticutils.git
elasticutils==0.7.dev

in the requirements.txt file, a pip install -r requirements.txt results in the following output:

Downloading/unpacking elasticutils==0.7.dev (from -r requirements.txt (line 20))
  Could not find a version that satisfies the requirement elasticutils==0.7.dev (from -r requirements.txt (line 20)) (from versions: )
No distributions matching the version for elasticutils==0.7.dev (from -r requirements.txt (line 20))

The documentation of the requirements file does not mention links using the git+git protocol specifier, so maybe this is just not supported.

Does anybody have a solution for my problem?

0

10 Answers 10

931

Normally your requirements.txt file would look something like this:

package-one==1.9.4
package-two==3.7.1
package-three==1.0.1
...

To specify a Github repo, you do not need the package-name== convention.

The examples below update package-two using a GitHub repo. The text after @ denotes the specifics of the package.

Specify commit hash (41b95ec in the context of updated requirements.txt):

package-one==1.9.4
package-two @ git+https://github.com/owner/repo@41b95ec
package-three==1.0.1

Specify branch name (main):

package-two @ git+https://github.com/owner/repo@main

Specify tag (0.1):

package-two @ git+https://github.com/owner/repo@0.1

Specify release (3.7.1):

package-two @ git+https://github.com/owner/repo@releases/tag/v3.7.1

Note that in certain versions of pip you will need to update the package version in the package's setup.py, or pip will assume the requirement is already satisfied and not install the new version. For instance, if you have 1.2.1 installed, and want to fork this package with your own version, you could use the above technique in your requirements.txt and then update setup.py to 1.2.1.1.

See also the pip documentation on VCS support.

13
  • 140
    Out of all the other answers, I can't believe none of them just showed a requirements file with a blend of "normal" reqs with a git one thrown in for comparison. I was so thrown off by what looked like command-line (-e) options. Thanks for showing a blend of both so I could put this in context!
    – Hendy
    Oct 22, 2017 at 19:47
  • 5
    Pointing to the release 3.7.1 with git+git://github.com/path/to/package-two@releases/tag/v3.7.1#egg=package-two did not work for me. What worked for me was git+git://github.com/path/to/package-two@3.7.1#egg=package-two.
    – Jean Paul
    Mar 4, 2020 at 13:20
  • 13
    This answer was very helpful. One thing though. Those git+git://... notation somehow caused ssh-relative errors on my Linux box. So I ended up switching them to git+https://... notation and then they work perfectly.
    – RayLuo
    Mar 28, 2020 at 2:49
  • 2
    I wasn't sure if you should what to put for egg=<package name>. I forked a project where the package name that you pip install has a dash in it (package-two), but the module you import has an underscore in it (package_two). I used the name of the imported module (with the underscore) and it works fine. Apr 15, 2021 at 18:31
  • 9
    GitHub dropped support for the git protocol -- you'll have to use https.
    – MikeTwo
    Nov 2, 2021 at 14:17
390

“Editable” packages syntax can be used in requirements.txt to import packages from a variety of VCS (git, hg, bzr, svn):

-e git://github.com/mozilla/elasticutils.git#egg=elasticutils

Also, it is possible to point to particular commit:

-e git://github.com/mozilla/elasticutils.git@000b14389171a9f0d7d713466b32bc649b0bed8e#egg=elasticutils
12
  • 4
    I didn't manage to checkout locally such an editable version (due to syntax problems, probably) and so ended up using the git+git variant (which worked). In the requirements.txt your version works, so thank you very much :)
    – Alfe
    May 16, 2013 at 10:42
  • 51
    What I did not understand is that the syntax showed is exactly what goes in requirements, i.e. there is no package name before the -e.
    – sage
    Dec 22, 2013 at 1:57
  • 6
    Adding "-e" isn't necessary depending on whether you want the package to be in editable mode, see answer by @qff . Feb 23, 2016 at 16:25
  • 17
    Shouldn't it be -e git+git:// instead of -e git://? I got a "should either be a path to a local project or a VCS url beginning with svn+, git+, hg+, or bzr+" error message.
    – Srini
    Feb 23, 2017 at 22:47
  • 2
    i get this Could not detect requirement name, please specify one with #egg=
    – abbood
    Jul 21, 2017 at 6:27
209

requirements.txt allows the following ways of specifying a dependency on a package in a git repository as of pip 7.0:1

[-e] git+git://git.myproject.org/SomeProject#egg=SomeProject
[-e] git+https://git.myproject.org/SomeProject#egg=SomeProject
[-e] git+ssh://git.myproject.org/SomeProject#egg=SomeProject
-e git+git@git.myproject.org:SomeProject#egg=SomeProject (deprecated as of Jan 2020)

For Github that means you can do (notice the omitted -e):

git+git://github.com/mozilla/elasticutils.git#egg=elasticutils

Why the extra answer?
I got somewhat confused by the -e flag in the other answers so here's my clarification:

The -e or --editable flag means that the package is installed in <venv path>/src/SomeProject and thus not in the deeply buried <venv path>/lib/pythonX.X/site-packages/SomeProject it would otherwise be placed in.2

Documentation

2
  • 14
    But note that if you omit the -e your next pip freeze may not give the correct results for this package
    – Maccesch
    Jun 21, 2017 at 13:05
  • 5
    Note: git+git@ urls are deprecated since Jan 2020. The others are still supported.
    – idbrii
    Dec 16, 2020 at 2:45
100

First, install with git+git or git+https, in any way you know. Example of installing kronok's branch of the brabeion project:

pip install -e git+https://github.com/kronok/brabeion.git@12efe6aa06b85ae5ff725d3033e38f624e0a616f#egg=brabeion

Second, use pip freeze > requirements.txt to get the right thing in your requirements.txt. In this case, you will get

-e git+https://github.com/kronok/brabeion.git@12efe6aa06b85ae5ff725d3033e38f624e0a616f#egg=brabeion-master

Third, test the result:

pip uninstall brabeion
pip install -r requirements.txt
6
  • 6
    pip freeze still list the package i use as a closed, anterior version. and not a direct github checkout Nov 11, 2015 at 20:36
  • 5
    You need to use `-e' option for 'pip freeze' to generate an url Mar 6, 2016 at 10:25
  • 3
    pip 9.0.1: no such option: -e
    – sds
    Jan 18, 2017 at 15:21
  • You mean git+https? In the text you say git+git and in the code git+https Jun 18, 2018 at 16:20
  • @AntonyHatchkins fixed. Nov 1, 2018 at 20:58
25

Since pip v1.5, (released Jan 1 2014: CHANGELOG, PR) you may also specify a subdirectory of a git repo to contain your module. The syntax looks like this:

pip install -e git+https://git.repo/some_repo.git#egg=my_subdir_pkg&subdirectory=my_subdir_pkg # install a python package from a repo subdirectory

Note: As a pip module author, ideally you'd probably want to publish your module in it's own top-level repo if you can. Yet this feature is helpful for some pre-existing repos that contain python modules in subdirectories. You might be forced to install them this way if they are not published to pypi too.

16

Github has zip endpoints that in my opinion are preferable to using the git protocol. The advantages are:

  • You don't have to specify #egg=<project name>
  • Git doesn't need to be installed in your environment, which is nice for containerized environments
  • It works much better with pip hashing and caching
  • The URL structure is easier to remember and more discoverable

You usually want requirements.txt entries to look like this, e.g. without the -e prefix:

https://github.com/org/package/archive/1a58aa586efd4bca37f2cfb9d9348958986aab6c.tar.gz

To install from main branch:

https://github.com/org/package/archive/main.tar.gz

There is also an equivalent .zip endpoint, but it was reported in a comment that always using the .tar.gz endpoint avoids problems with unicode package names.

3
  • 4
    As mentioned in a comment of this similar SO answer, the zip extractor can have issues with unicode package names. Specifying .tar.gz instead of .zip will fix this. Sep 23, 2021 at 10:20
  • 1
    @ryanjdillon I updated the answer to recommend .tar.gz instead of .zip. Oct 12, 2021 at 8:41
  • This is the one answer I was looking for, thanks.
    – ramnes
    Feb 15, 2022 at 19:14
14

None of these answers worked for me. The only thing that worked was:

git+https://github.com/path_to_my_project.git

No "e", no double "git" and no previous installs necessary.

8

It seems like this is also a valid format:

gym-tictactoe @ git+https://github.com/haje01/gym-tictactoe.git@84e22fc28fe192ba0040bdd56a697f63d3d4a3d5

If you do a pip install "git+https://github.com/haje01/gym-tictactoe.git", then look at what got installed by running pip freeze, you will see the package described in this format and can copy and paste into requirements.txt.

2
  • This fixes my issue from the private repo and setup.py install_requires options. Thanks! Jan 28, 2022 at 10:31
  • 1
    Just needed this today, and the solutions in older answers did not work for me, but this one worked well. I wonder if there was a change in pip? In particular, the #egg=gym-tictactoe at the end failed, but gym-tictactoe @ at the beginning worked, with the same git+https:... URL either way.
    – someone
    Apr 13 at 18:48
5

I'm finding that it's kind of tricky to get pip3 (v9.0.1, as installed by Ubuntu 18.04's package manager) to actually install the thing I tell it to install. I'm posting this answer to save anyone's time who runs into this problem.

Putting this into a requirements.txt file failed:

git+git://github.com/myname/myrepo.git@my-branch#egg=eggname

By "failed" I mean that while it downloaded the code from Git, it ended up installing the original version of the code, as found on PyPi, instead of the code in the repo on that branch.

However, installing the commmit instead of the branch name works:

git+git://github.com/myname/myrepo.git@d27d07c9e862feb939e56d0df19d5733ea7b4f4d#egg=eggname
2
  • Are you sure your branch is also remote?
    – Alfe
    Dec 9, 2019 at 9:41
  • It wasn't pointing to a local copy, if that's what you're wondering. Jan 1, 2020 at 6:31
4

For private repositories, I found that these two work fine for me:

pip install https://${GITHUB_TOKEN}@github.com/owner/repo/archive/main.tar.gz

Where main.tar.gz refers to the main branch of your repo and can be replaced with other branch names. For more information and using the more recent Github API see here:

pip install https://${GITHUB_TOKEN}@api.github.com/repos/owner/repo/tarball/master

If you have git installed and available, then

pip install git+https://${GITHUB_TOKEN}@github.com/owner/repo.git@main

achieves the same, and it also allows for some more flexibility by appending @branch or @tag or @commit-hash. That approach, however, actually clones the repo into a local temp folder which can take a noticeable amount of time.

You can use the URLs in your requirements.txt, too.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

Not the answer you're looking for? Browse other questions tagged or ask your own question.