Skip to content

A Fresh Approach to R Package Installation

pak installs R packages from CRAN, Bioconductor, GitHub, URLs, git repositories, local files and directories. It is an alternative to install.packages() and devtools::install_github(). pak is fast, safe and convenient.

🚀 Short tour

Install or update packages from CRAN or Bioconductor

pak::pkg_install("tibble")
#>  Loading metadata database ... done                                            
#>                                                                                 
#> → Will install 11 packages.                                                     
#> → Will download 11 CRAN packages (4.52 MB).                                     
#> + cli         3.6.2 [bld][cmp][dl] (569.77 kB)                                  
#> + fansi       1.0.6 [bld][cmp][dl] (482.48 kB)                                  
#> + glue        1.7.0 [bld][cmp][dl] (105.42 kB)                                  
#> + lifecycle   1.0.4 [bld][dl] (107.66 kB)                                       
#> + magrittr    2.0.3 [bld][cmp][dl] (267.07 kB)                                  
#> + pillar      1.9.0 [bld][dl] (444.53 kB)                                       
#> + pkgconfig   2.0.3 [bld][dl] (6.08 kB)                                         
#> + rlang       1.1.3 [bld][cmp][dl] (763.76 kB)                                  
#> + tibble      3.2.1 [bld][cmp][dl] (565.98 kB)                                  
#> + utf8        1.2.4 [bld][cmp][dl] (241.08 kB)                                  
#> + vctrs       0.6.5 [bld][cmp][dl] (969.07 kB)                                  
#>                                                                                 
#>  Getting 11 pkgs (4.52 MB)                                                     
#>  Got glue 1.7.0 (source) (105.42 kB)                                           
#>  Got pkgconfig 2.0.3 (source) (6.08 kB)                                        
#>  Got fansi 1.0.6 (source) (482.48 kB)                                          
#>  Got lifecycle 1.0.4 (source) (107.66 kB)                                      
#>  Got utf8 1.2.4 (source) (241.08 kB)                                           
#>  Got cli 3.6.2 (source) (569.77 kB)                                            
#>  Got pillar 1.9.0 (source) (444.53 kB)                                         
#>  Got tibble 3.2.1 (source) (565.98 kB)                                         
#>  Got magrittr 2.0.3 (source) (267.07 kB)                                       
#>  Got rlang 1.1.3 (source) (763.76 kB)                                          
#>  Got vctrs 0.6.5 (source) (969.07 kB)                                          
#>  Building cli 3.6.2                                                            
#>  Building fansi 1.0.6                                                          
#>  Building glue 1.7.0                                                           
#>  Building magrittr 2.0.3                                                       
#>  Built magrittr 2.0.3 (2.1s)                                                   
#>  Building pkgconfig 2.0.3                                                      
#>  Built glue 1.7.0 (2.5s)                                                       
#>  Building rlang 1.1.3                                                          
#>  Built pkgconfig 2.0.3 (1.4s)                                                  
#>  Building utf8 1.2.4                                                           
#>  Built fansi 1.0.6 (6.5s)                                                      
#>  Installed fansi 1.0.6  (46ms)                                                 
#>  Installed glue 1.7.0  (36ms)                                                  
#>  Installed magrittr 2.0.3  (39ms)                                              
#>  Installed pkgconfig 2.0.3  (31ms)                                             
#>  Built utf8 1.2.4 (5s)                                                         
#>  Installed utf8 1.2.4  (103ms)                                                 
#>  Built cli 3.6.2 (12.2s)                                                       
#>  Installed cli 3.6.2  (33ms)                                                   
#>  Built rlang 1.1.3 (12.8s)                                                     
#>  Installed rlang 1.1.3  (38ms)                                                 
#>  Building lifecycle 1.0.4                                                      
#>  Built lifecycle 1.0.4 (1.4s)                                                  
#>  Installed lifecycle 1.0.4  (1s)                                               
#>  Building vctrs 0.6.5                                                          
#>  Built vctrs 0.6.5 (16.1s)                                                     
#>  Installed vctrs 0.6.5  (46ms)                                                 
#>  Building pillar 1.9.0                                                         
#>  Built pillar 1.9.0 (3.3s)                                                     
#>  Installed pillar 1.9.0  (1s)                                                  
#>  Building tibble 3.2.1                                                         
#>  Built tibble 3.2.1 (3s)                                                       
#>  Installed tibble 3.2.1  (30ms)                                                
#>  1 pkg + 10 deps: added 11, dld 11 (4.52 MB) [48.5s]                           

Install packages from GitHub

pak::pkg_install("tidyverse/tibble")
#>                                                                                 
#> → Will update 1 package.                                                        
#> → The package (0 B) is cached.                                                  
#> + tibble 3.2.1 → 3.2.1.9016 [bld][cmp] (GitHub: 975fa34)                        
#>                                                                                 
#>  No downloads are needed, 1 pkg is cached                                      
#>  Got tibble 3.2.1.9016 (source) (1.32 MB)                                      
#>  Packaging tibble 3.2.1.9016                                                   
#>  Packaged tibble 3.2.1.9016 (497ms)                                            
#>  Building tibble 3.2.1.9016                                                    
#>  Built tibble 3.2.1.9016 (2.9s)                                                
#>  Installed tibble 3.2.1.9016 (github::tidyverse/tibble@975fa34) (1s)           
#>  1 pkg + 10 deps: kept 10, upd 1, dld 1 (NA B) [7s]                            

Look up dependencies

pak::pkg_deps_tree("tibble")
#> tibble 3.2.1 [new][bld][cmp]                                                    
#> ├─fansi 1.0.6 [new][bld][cmp]                                                   
#> ├─lifecycle 1.0.4 [new][bld]                                                    
#> │ ├─cli 3.6.2 [new][bld][cmp]                                                   
#> │ ├─glue 1.7.0 [new][bld][cmp]                                                  
#> │ └─rlang 1.1.3 [new][bld][cmp]                                                 
#> ├─magrittr 2.0.3 [new][bld][cmp]                                                
#> ├─pillar 1.9.0 [new][bld]                                                       
#> │ ├─cli                                                                         
#> │ ├─fansi                                                                       
#> │ ├─glue                                                                        
#> │ ├─lifecycle                                                                   
#> │ ├─rlang                                                                       
#> │ ├─utf8 1.2.4 [new][bld][cmp]                                                  
#> │ └─vctrs 0.6.5 [new][bld][cmp]                                                 
#> │   ├─cli                                                                       
#> │   ├─glue                                                                      
#> │   ├─lifecycle                                                                 
#> │   └─rlang                                                                     
#> ├─pkgconfig 2.0.3 [new][bld]                                                    
#> ├─rlang                                                                         
#> └─vctrs                                                                         
#>                                                                                 
#> Key:  [new] new | [bld] build | [cmp] compile                                   

Explain dependencies

pak::pkg_deps_explain("tibble", "rlang")
#> tibble -> lifecycle -> rlang                                                    
#> tibble -> pillar -> lifecycle -> rlang                                          
#> tibble -> pillar -> rlang                                                       
#> tibble -> pillar -> vctrs -> lifecycle -> rlang                                 
#> tibble -> pillar -> vctrs -> rlang                                              
#> tibble -> rlang                                                                 
#> tibble -> vctrs -> lifecycle -> rlang                                           
#> tibble -> vctrs -> rlang                                                        

Install a local package and its dependencies

pak::local_install("cli")
#>                                                                                 
#> → Will update 1 package.                                                        
#> → The package (0 B) is cached.                                                  
#> + cli 3.6.2 → 3.6.2 [bld][cmp]                                                  
#>                                                                                 
#>  No downloads are needed, 1 pkg is cached                                      
#>  Got cli 3.6.2 (source) (569.77 kB)                                            
#>  Packaging cli 3.6.2                                                           
#>  Packaged cli 3.6.2 (791ms)                                                    
#>  Building cli 3.6.2                                                            
#>  Built cli 3.6.2 (8.2s)                                                        
#>  Installed cli 3.6.2 (local) (36ms)                                            
#>  1 pkg: upd 1, dld 1 (569.77 kB) [9.8s]                                        

How do I … ?

Start at Get Started with pak to solve specific issues.

Reference

The complete reference of pak functions is the most complete source of information about pak.

I have a(nother) question

Don’t hesitate to ask at the RStudio Community forum. Use the pak tag.

I would like to report a bug

Head to the pak issue tracker.

Features

Fast - parallel downloads and installation, caching, etc.

🦺 Safe - dependency solver, system dependency solver, etc.

🏪 Convenient - packages from multiple sources, time travel, etc.

See the complete list of awesome features.

⬇️ Installation

Pre-built binaries

Install a binary build of pak from our repository on GitHub:

install.packages("pak", repos = sprintf("https://r-lib.github.io/p/pak/stable/%s/%s/%s", .Platform$pkgType, R.Version()$os, R.Version()$arch))

This is supported for the following systems:

OS CPU R version
Linux x86_64 R 3.5.0 - R-devel
Linux aarch64 R 3.5.0 - R-devel
macOS High Sierra+ x86_64 R 3.5.0 - R-devel
macOS Big Sur+ aarch64 R 4.1.0 - R-devel
Windows x86_64 R 3.5.0 - R-devel

For macOS we only support the official CRAN R build. Other builds, e.g. Homebrew R, are not supported.

Install from CRAN

Install the released version of the package from CRAN as usual:

This potentially needs a C compiler on platforms CRAN does not have binaries packages for.

Other platforms and nightly builds

See the installation page!

📘 License

GPL-3 © RStudio