install_keras: Install Keras and the TensorFlow backend

Description Usage Arguments GPU Installation Windows Installation Custom Installation Additional Packages Examples

View source: R/install.R

Description

Keras and TensorFlow will be installed into an "r-tensorflow" virtual or conda environment. Note that "virtualenv" is not available on Windows (as this isn't supported by TensorFlow).

Usage

1
2
3
install_keras(method = c("auto", "virtualenv", "conda"),
  conda = "auto", version = "default", tensorflow = "default",
  extra_packages = c("tensorflow-hub"), ...)

Arguments

method

Installation method ("virtualenv" or "conda")

conda

Path to conda executable (or "auto" to find conda using the PATH and other conventional install locations).

version

Version of Keras to install. Specify "default" to install the latest release. Otherwise specify an alternate version (e.g. "2.2.2").

tensorflow

TensorFlow version to install. Specify "default" to install the CPU version of the latest release. Specify "gpu" to install the GPU version of the latest release.

You can also provide a full major.minor.patch specification (e.g. "1.1.0"), appending "-gpu" if you want the GPU version (e.g. "1.1.0-gpu").

Alternatively, you can provide the full URL to an installer binary (e.g. for a nightly binary).

extra_packages

Additional PyPI packages to install along with Keras and TensorFlow.

...

Other arguments passed to tensorflow::install_tensorflow().

GPU Installation

Keras and TensorFlow can be configured to run on either CPUs or GPUs. The CPU version is much easier to install and configure so is the best starting place especially when you are first learning how to use Keras. Here's the guidance on CPU vs. GPU versions from the TensorFlow website:

To install the GPU version:

  1. Ensure that you have met all installation prerequisites including installation of the CUDA and cuDNN libraries as described in TensorFlow GPU Prerequistes.

  2. Pass tensorflow = "gpu" to install_keras(). For example:

      install_keras(tensorflow = "gpu")
    

Windows Installation

The only supported installation method on Windows is "conda". This means that you should install Anaconda 3.x for Windows prior to installing Keras.

Custom Installation

Installing Keras and TensorFlow using install_keras() isn't required to use the Keras R package. You can do a custom installation of Keras (and desired backend) as described on the Keras website and the Keras R package will find and use that version.

See the documentation on custom installations for additional information on how version of Keras and TensorFlow are located by the Keras package.

Additional Packages

If you wish to add additional PyPI packages to your Keras / TensorFlow environment you can either specify the packages in the extra_packages argument of install_keras(), or alternatively install them into an existing environment using the reticulate::py_install() function.

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
## Not run: 

# default installation
library(keras)
install_keras()

# install using a conda environment (default is virtualenv)
install_keras(method = "conda")

# install with GPU version of TensorFlow
# (NOTE: only do this if you have an NVIDIA GPU + CUDA!)
install_keras(tensorflow = "gpu")

# install a specific version of TensorFlow
install_keras(tensorflow = "1.2.1")
install_keras(tensorflow = "1.2.1-gpu")


## End(Not run)

keras documentation built on Oct. 9, 2019, 1:04 a.m.