data/kb/dependencies/install-package-pypi-github.md

---
title: How to install a package not on PyPI/Conda but available on GitHub
slug: /knowledge-base/dependencies/install-package-not-pypi-conda-available-github
---

# How to install a package not on PyPI/Conda but available on GitHub

## Overview

Are you trying to deploy your app to [Streamlit Community Cloud](/deploy/streamlit-community-cloud), but don't know how to specify a [Python dependency](/deploy/streamlit-community-cloud/deploy-your-app/app-dependencies#add-python-dependencies) in your requirements file that is available on a public GitHub repo but not any package index like PyPI or Conda? If so, continue reading to find out how!

Let's suppose you want to install `SomePackage` and its Python dependencies from GitHub, a hosting service for the popular version control system (VCS) Git. And suppose `SomePackage` is found at the the following URL: `https://github.com/SomePackage.git`.

pip (via `requirements.txt`) [supports](https://pip.pypa.io/en/stable/topics/vcs-support/) installing from GitHub. This support requires a working executable to be available (for Git). It is used through a URL prefix: `git+`.

## Specify the GitHub web URL

To install `SomePackage`, innclude the following in your `requirements.txt` file:

```bash
git+https://github.com/SomePackage#egg=SomePackage
```

You can even specify a "git ref" such as branch name, a commit hash or a tag name, as shown in the examples below.

## Specify a Git branch name

Install `SomePackage` by specifying a branch name such as `main`, `master`, `develop`, etc, in `requirements.txt`:

```bash
git+https://github.com/SomePackage.git@main#egg=SomePackage
```

## Specify a commit hash

Install `SomePackage` by specifying a commit hash in `requirements.txt`:

```bash
git+https://github.com/SomePackage.git@eb40b4ff6f7c5c1e4366cgfg0671291bge918#egg=SomePackage
```

## Specify a tag

Install `SomePackage` by specifying a tag in `requirements.txt`:

```bash
git+https://github.com/[email protected]#egg=SomePackage
```

## Limitations

It is currently **not possible** to install private packages from private GitHub repos using the URI form:

```bash
git+https://{token}@github.com/user/project.git@{version}
```

where `version` is a tag, a branch, or a commit. And `token` is a personal access token with read only permissions. Streamlit Community Cloud only supports installing public packages from public GitHub repos.