node package manager



Download and extract a git repository (GitHub, GitLab, Bitbucket) from node.


$ npm install download-git-repo


download(repository, destination, options, callback)

Download a git repository to a destination folder with options, and callback.


The short hand repository string to download the repository from:

  • GitHub - github:owner/name or simply owner/name
  • GitLab - gitlab:owner/name
  • Bitbucket - bitbucket:owner/name

The repository parameter defaults to the master branch, but you can specify a branch or tag as a URL fragment like owner/name#my-branch. In addition to specifying the type of where to download, you can also specify a custom origin like Custom origin will default to https or git@ for http and clone downloads respectively, unless protocol is specified. Feel free to submit an issue or pull request for additional origin options.


The file path to download the repository to.


An optional options object parameter with download options. Options include:

  • clone - boolean default false - If true use git clone instead of an http download. While this can be a bit slower, it does allow private repositories to be used if the appropriate SSH keys are setup.


The callback function as function (err).


Using http download from Github repository at master.

download('flipxfx/download-git-repo-fixture', 'test/tmp', function (err) {
  console.log(err ? 'Error' : 'Success')

Using git clone from Bitbucket repository at my-branch.

download('bitbucket:flipxfx/download-git-repo-fixture#my-branch', 'test/tmp', { clone: true }, function (err) {
  console.log(err ? 'Error' : 'Success')

Using http download from GitLab repository with custom origin.

download('', 'test/tmp', function (err) {
  console.log(err ? 'Error' : 'Success')

Using git clone from GitLab repository with custom origin and protocol. Note that the repository type (github, gitlab etc.) is not required if cloning from a custom origin.

download('', 'test/tmp', { clone: true }, function (err) {
  console.log(err ? 'Error' : 'Success')


To ianstormtaylor/download-github-repo for the head start.