Download and install R packages stored in 'GitHub', 'BitBucket', or plain 'subversion' or 'git' repositories. This package is a lightweight replacement of the 'install_*' functions in 'devtools'. Indeed most of the code was copied over from 'devtools'.
Download and install R packages stored in 'GitHub', 'BitBucket', or plain 'subversion' or 'git' repositories. This package is a lightweight replacement of the 'install_*' functions in devtools. Indeed most of the code was copied over from 'devtools'.
remotes can install itself from GitHub, it does not depend on any R
package, it does not contain compiled code, and does not need any
external software (for most of the functionality at least).
You can install
remotes from GitHub. If you already have a previous
remotes installed, you can use that to install the new
Otherwise you can call the supplied
file directly, from within R:
Note that most of the examples here use GitHub. See below for other supported repository types.
To install the latest version of a package in the
master branch from
GitHub, you can use the
user/repo form. Note that
user can also be
If the R package is inside a subdirectory of the root directory, then give this subdirectory as well:
To install a certain branch or commit or tag, append it to the
repo name, after an
To install the latest release, append
@*release to the repo
To install a pull request, append
# and the id (an integer number)
of the pull request to the repo name:
Dependencies are automatically installed from CRAN. By default, outdated dependencies are automatically upgraded.
It is also possible to install dependencies from GitHub. For this
you need to add a
Remotes field to the
Its format is:
Remotes: [remote::]repo_spec, [remote::]repo_spec, ...
repo_spec is any repository specification
can handle. If
remote:: is missing,
github:: is assumed.
Other possible values:
remotes supports the
Additional_repositories field in
DESCRIPTION. This is a way to specify dependencies from non-CRAN
package repositories. See the [Writing R extensions]
manual for details.
BioConductor packages are automatically detected and their
dependencies are installed from BioConductor. The
package, which is needed to install them, is also automatically
install_git. They need either a system git installation, or the git2r R package.
install_svn. They need a system subversion installation.
install_version. This includes outdated and archived packages as well.
If a package in a git repository has submodules, then the installation will likely fail. Nevertheless, a warning is given in this case.
GPL (>= 2) © Mango Solutions, RStudio
First public release.