> [!WARNING] > **Warning:** TensorFlow for Java is deprecated and will be removed in a future version of TensorFlow once [the replacement](https://tensorflow.github.io/java) is stable. TensorFlow provides a [Java API](https://www.tensorflow.org/api_docs/java/reference/org/tensorflow/package-summary)--- useful for loading models created with Python and running them within a Java application. ## Nightly Libtensorflow Java packages Libtensorflow JNI packages are built nightly and uploaded to GCS for all supported platforms. They are uploaded to the [libtensorflow-nightly GCS bucket](https://storage.googleapis.com/libtensorflow-nightly) and are indexed by operating system and date built. ## Supported Platforms TensorFlow for Java is supported on the following systems: - Ubuntu 16.04 or higher; 64-bit, x86 - macOS 10.12.6 (Sierra) or higher - Windows 7 or higher; 64-bit, x86 To use TensorFlow on Android see [TensorFlow Lite](https://tensorflow.org/lite) ## TensorFlow with Apache Maven To use TensorFlow with [Apache Maven](https://maven.apache.org), add the dependency to the project's `pom.xml` file: org.tensorflow tensorflow 2.4.0 ### GPU support If your system has [GPU support](https://www.tensorflow.org/install/pip), add the following TensorFlow dependencies to the project's `pom.xml` file: org.tensorflow libtensorflow 2.4.0 org.tensorflow libtensorflow_jni_gpu 2.4.0 ### Example program This example shows how to build an Apache Maven project with TensorFlow. First, add the TensorFlow dependency to the project's `pom.xml` file: 4.0.0 org.myorg hellotensorflow 1.0-SNAPSHOT HelloTensorFlow 1.7 1.7 org.tensorflow tensorflow 1.14.0 Create the source file (`src/main/java/HelloTensorFlow.java`): import org.tensorflow.Graph; import org.tensorflow.Session; import org.tensorflow.Tensor; import org.tensorflow.TensorFlow; public class HelloTensorFlow { public static void main(String[] args) throws Exception { try (Graph g = new Graph()) { final String value = "Hello from " + TensorFlow.version(); // Construct the computation graph with a single operation, a constant // named "MyConst" with a value "value". try (Tensor t = Tensor.create(value.getBytes("UTF-8"))) { // The Java API doesn't yet include convenience functions for adding operations. g.opBuilder("Const", "MyConst").setAttr("dtype", t.dataType()).setAttr("value", t).build(); } // Execute the "MyConst" operation in a Session. try (Session s = new Session(g); // Generally, there may be multiple output tensors, // all of them must be closed to prevent resource leaks. Tensor output = s.runner().fetch("MyConst").run().get(0)) { System.out.println(new String(output.bytesValue(), "UTF-8")); } } } } Compile and execute: ```bash mvn -q compile exec:java # Use -q to hide logging ``` The command outputs: `Hello from version` > [!TIP] > **Success:** TensorFlow for Java is configured. ## TensorFlow with the JDK TensorFlow can be used with the JDK through the Java Native Interface (JNI). ### Download 1. Download the TensorFlow Jar Archive (JAR): [libtensorflow.jar](https://storage.googleapis.com/tensorflow/libtensorflow/libtensorflow-1.14.0.jar) 2. Download and extract the Java Native Interface (JNI) file for your operating system and processor support: | JNI version | URL | |---|---| | Linux || | Linux CPU only | | | Linux GPU support | | | macOS || | macOS CPU only | | | Windows || | Windows CPU only | | | Windows GPU support | | > [!NOTE] > **Note:** On Windows, the native library (`tensorflow_jni.dll`) requires `msvcp140.dll` at runtime. See the [Windows build from source](https://www.tensorflow.org/install/source_windows) guide to install the [Visual C++ 2019 Redistributable](https://visualstudio.microsoft.com/vs/). ### Compile Using the `HelloTensorFlow.java` file from the [previous example](https://www.tensorflow.org/install/lang_java_legacy#example_program), compile a program that uses TensorFlow. Make sure the `libtensorflow.jar` is accessible to your `classpath`: ``` javac -cp libtensorflow-2.4.0.jar HelloTensorFlow.java ``` ### Run To execute a TensorFlow Java program, the JVM must access `libtensorflow.jar` and the extracted JNI library.
### Linux / macOS ``` java -cp libtensorflow-2.4.0.jar:. -Djava.library.path=./jni HelloTensorFlow ``` ### Windows ``` java -cp libtensorflow-2.4.0.jar;. -Djava.library.path=jni HelloTensorFlow ```
The command outputs: `Hello from version` > [!TIP] > **Success:** TensorFlow for Java is configured. ## Build from source TensorFlow is open source. Read [the instructions](https://github.com/tensorflow/tensorflow/blob/master/tensorflow/java/README.md) to build TensorFlow's Java and native libraries from source code.