blob: c2801641d231c3aa1f607eb201ff72f385550ab9 [file] [log] [blame]
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<!doctype html><html lang="en"><meta charset="utf-8"><meta http-equiv="X-UA-Compatible" content="IE=edge"><meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"><meta name="description" content="An open source API to convert natural language into actions."><meta name="author" content="NLPCraft."><title>Apache NLPCraft - Natural Language Interface</title><link href="//netdna.bootstrapcdn.com/bootstrap/4.1.0/css/bootstrap.min.css" rel="stylesheet"><link href="//use.fontawesome.com/releases/v5.7.1/css/all.css" integrity="sha384-fnmOCqbTlWIlj8LyTjo7mOUStjsKC4pOpQbqyi7RrhN7udi9RwhKkMHpvLbHG9Sr" rel="stylesheet" crossorigin="anonymous"><link href="/ext/syntaxhighlighter/styles/shCoreNLPCraft.css" rel="stylesheet" type="text/css"><link href="/ext/syntaxhighlighter/styles/shThemeNLPCraft.css" rel="stylesheet" type="text/css"><link href="//fonts.googleapis.com/css?family=Amatic+SC|Roboto+Mono" rel="stylesheet"> <script src="/ext/syntaxhighlighter/scripts/XRegExp.js" type="text/javascript"></script> <script src="/ext/syntaxhighlighter/scripts/shCore.js" type="text/javascript"></script> <script src="/ext/syntaxhighlighter/scripts/shBrushXml.js" type="text/javascript"></script> <script src="/ext/syntaxhighlighter/scripts/shBrushPlain.js" type="text/javascript"></script> <script src="/ext/syntaxhighlighter/scripts/shBrushJava.js" type="text/javascript"></script> <script src="/ext/syntaxhighlighter/scripts/shBrushScala.js" type="text/javascript"></script> <script src="/ext/syntaxhighlighter/scripts/shBrushPython.js" type="text/javascript"></script> <script src="/ext/syntaxhighlighter/scripts/shBrushJScript.js" type="text/javascript"></script> <script async defer src="https://buttons.github.io/buttons.js"></script><link rel="stylesheet" type="text/css" href="/assets/css/style.css"/> <script type="text/javascript" src="//use.typekit.net/pso2adz.js"></script> <script type="text/javascript"> try { Typekit.load(); } catch(e) { // Ignore. } </script><nav class="navbar navbar-expand-lg navbar-light bg-light" id="top-header"> <a class="navbar-brand mr-4" href="/index.html"> <img src="/images/nlpcraft_logo_white.gif" height="24px"> </a> <button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbarSupportedContent" aria-controls="navbarSupportedContent" aria-expanded="false" aria-label="Toggle navigation"> <span class="navbar-toggler-icon"></span> </button><div class="collapse navbar-collapse" id="navbarSupportedContent"><ul class="navbar-nav mr-auto"><li class="nav-item"> <a class="nav-link" href="/index.html#features">Features</a><li class="nav-item"> <a class="nav-link" href="/docs.html">Docs</a><li class="nav-item"> <a class="nav-link" href="/download.html">Downloads <i class="fas fa-download"></i></a><li class="nav-item"> <a class="nav-link" href="/community.html">Community</a><li class="nav-item"> <a class="nav-link" href="/use-cases.html">Use Cases</a></ul><ul class="navbar-nav ml-auto"><li class="nav-item mr-2"> <a class="nav-link" href="/download.html">v.0.5.0</a><li class="nav-item"> <a class="nav-link fork-link" target="github" href="https://github.com/apache/incubator-nlpcraft">GitHub <img height="20px" src="/images/github_logo_white.png"></a></ul></div></nav><div class="container-fluid"><div class="navbar-aligned"><ol class="breadcrumb"><li class="mr-1"><a href="/index.html">Home</a><li class="mr-1 active">Download</ol><h1 class="page-title"> <span><i class="fas fa-fw fa-download"></i> Download</span></h1><div id="downloads" class="three-cols-container"><div class="col-md-2 first-column"><ul class="side-nav"><li class="side-nav-title">Introduction<li><a href="/docs.html">Overview</a><li><a href="/installation.html">Installation</a><li><a href="/getting-started.html">Getting Started</a></ul></div><div class="col-md-8 second-column"><section id="prerequisites"><h2 class="section-title">Support</h2><p> Here's the list of tools you will need to get started with NLPCraft:</p><ul><li> <a target=_new href="https://www.oracle.com/technetwork/java/javase/downloads/index.html">Java SE Runtime Environment</a> (JRE) or <a target=_new href="https://openjdk.java.net/">OpenJDK</a> ver. 8 or later installed.<ul><li> Java 8 and Scala 2.11 are required to build NLPCraft (Java 11 is NOT supported).<li> For runtime Java 8 or later is supported.</ul><li> Latest versions of <a target=_ href="https://git-scm.com/downloads">Git</a> and <a target=_ href="https://maven.apache.org/install.html">Maven</a>.</ul><p> For any questions, feedback or suggestions:</p><ul><li> File a bug or improvement in <a target="jira" href="https://issues.apache.org/jira/projects/NLPCRAFT">NLPCraft JIRA</a><li> Post a question at <i class="fab fa-stack-overflow"></i>&nbsp;<a href="https://stackoverflow.com/questions/ask">Stack Overflow</a> using <code>nlpcraft</code> tag<li> Access <a target="github" href="https://github.com/apache/incubator-nlpcraft">GitHub</a> mirror repository.<li> Join project developers on <a href="mailto:dev@nlpcraft.apache.org">dev@nlpcraft.apache.org</a></ul><p> By downloading NLPCraft you are agreeing to <a href="https://www.apache.org/licenses/LICENSE-2.0">Apache 2.0 License</a> terms <span class="amp">&amp;</span> conditions.</p></section><section id="src"><h2 class="section-title">Source Release</h2><p> Download the NLPCraft release - <code><b>0.5.0</b></code> is the latest version:</p><table class="gradient-table max-width"><thead><tr><th>File Name<th>Version<th>Release Date<th>Signatures<th><tbody><tr><td> <i class="fa fa-fw fa-download"></i> <a href="https://github.com/apache/incubator-nlpcraft/releases/download/0.5.0/apache-nlpcraft-0.5.0-src.zip">apache-nlpcraft-incubating-0.5.0-src.zip</a><td>0.5.0<td>Apr 16, 2020<td class="download-sigs"> <a href="https://github.com/apache/incubator-nlpcraft/releases/download/0.5.0/apache-nlpcraft-0.5.0-src.zip.sha256">SHA256</a> <a href="https://github.com/apache/incubator-nlpcraft/releases/download/0.5.0/apache-nlpcraft-0.5.0-src.zip.sig">PGP</a><td> <a href="/release-notes-0.5.0.html"><i class="fas fa-fw fa-file-alt"></i></a> <a target=_ href="/apis/javadoc-0.5.0/index.html"><i class="fab fa-fw fa-java"></i></a> <a target="github" href="https://github.com/apache/incubator-nlpcraft/tree/0.5.0"><i class="fab fa-fw fa-github"></i></a></table><div class="bq info"><p> Releases marked with <i class="fas fa-fw fa-bomb"></i> are <b>NOT</b> backward compatible.</p></div></section><section id="zip"><h2 class="section-title">Binary Release / Docker</h2><p> Download the NLPCraft binary release - <code><b>0.5.0</b></code> is the latest version:</p><table class="gradient-table max-width"><thead><tr><th>File Name<th>Version<th>Release Date<th>Signatures<th><tbody><tr><td> <i class="fa fa-fw fa-download"></i> <a href="https://github.com/apache/incubator-nlpcraft/releases/download/0.5.0/apache-nlpcraft-0.5.0.zip">apache-nlpcraft-incubating-bin-0.5.0.zip</a><td>0.5.0<td>Apr 16, 2020<td class="download-sigs"> <a href="https://github.com/apache/incubator-nlpcraft/releases/download/0.5.0/apache-nlpcraft-0.5.0.zip.sha256">SHA256</a> <a href="https://github.com/apache/incubator-nlpcraft/releases/download/0.5.0/apache-nlpcraft-0.5.0.zip.sig">PGP</a><td> <a href="/release-notes-0.5.0.html"><i class="fas fa-fw fa-file-alt"></i></a> <a target=_ href="/apis/javadoc-0.5.0/index.html"><i class="fab fa-fw fa-java"></i></a> <a target="github" href="https://github.com/apache/incubator-nlpcraft/tree/0.5.0"><i class="fab fa-fw fa-github"></i></a></table><div class="bq warn"><p> <b>Apache Release Policy</b></p><p> Binary downloads are provided for the convenience of our users and are not official Apache NLPCraft releases. In order to verify the release, we recommend that you download the official source distribution and <a href="#verification">verify</a> the signatures of the downloaded files before opening them.</p><p> See <a target="asf" href="http://www.apache.org/dev/release.html#what">more</a> information about Apache release policy.</p></div><div class="bq info"><p> Releases marked with <i class="fas fa-fw fa-bomb"></i> are <b>NOT</b> backward compatible.</p></div></section><section id="build"><h2 class="section-title">Building Binaries</h2><p> To build binaries from the source release download the <a href="#src">source release</a> and run the following commands:</p><b>Unpack the source package:</b><pre class="brush: plain">
$ unzip -q apache-nlpcraft-incubating-0.5.0.zip
$ cd apache-nlpcraft-incubating-0.5.0
</pre><b>Build NLPCraft:</b><pre class="brush: plain">
$ mvn clean package -DskipTests
</pre><p> Built JARs and Javadoc will be located in <code>target</code> sub-folder.</p></section><section id="verification"><h2 class="section-title">Release Verification</h2><p> We highly recommend to verify the integrity and authenticity of the ZIP archive by comparing cryptographic signatures.Following instructions assume binary release on Mac OS/Linux environment but the verification steps are similar for Windows.</p><h3 class="section-title">Mac OS</h3><nav><div class="nav nav-tabs" role="tablist"> <a class="nav-item nav-link active" data-toggle="tab" href="#nav-macos-sha256" role="tab" aria-controls="nav-home" aria-selected="true">SHA256</a> <a class="nav-item nav-link" data-toggle="tab" href="#nav-macos-pgp" role="tab" aria-controls="nav-home" aria-selected="true">PGP</a></div></nav><div class="tab-content"><div class="tab-pane fade show active" id="nav-macos-sha256" role="tabpanel"><pre class="brush: plain, highlight: [2,3]">
# Run these two commands and compare generated hashes:
$ openssl dgst -sha256 apache-nlpcraft-incubating-0.5.0.zip
$ cat apache-nlpcraft-incubating-0.5.0.zip.sha256
</pre></div><div class="tab-pane fade show" id="nav-macos-pgp" role="tabpanel"><pre class="brush: plain, highlight: [2]">
# NOTE: make sure to have GPGTools (gpgtools.org) installed.
$ gpg --verify apache-nlpcraft-incubating-0.5.0.zip.asc apache-nlpcraft-incubating-0.5.0.zip
</pre></div></div><h3 class="section-title">Linux</h3><nav><div class="nav nav-tabs" role="tablist"> <a class="nav-item nav-link active" data-toggle="tab" href="#nav-linux-sha256" role="tab" aria-controls="nav-home" aria-selected="true">SHA256</a> <a class="nav-item nav-link" data-toggle="tab" href="#nav-linux-pgp" role="tab" aria-controls="nav-home" aria-selected="true">PGP</a></div></nav><div class="tab-content"><div class="tab-pane fade show active" id="nav-linux-sha256" role="tabpanel"><pre class="brush: plain, highlight: [1]">
$ sha256sum --check apache-nlpcraft-incubating-0.5.0.zip.sha256
</pre></div><div class="tab-pane fade show" id="nav-linux-pgp" role="tabpanel"><pre class="brush: plain, highlight: [1]">
$ gpg --verify apache-nlpcraft-incubating-0.5.0.zip.asc apache-nlpcraft-incubating-0.5.0.zip
</pre></div></div></section><section id="maven"><h2 class="section-title">Maven/Grape/SBT</h2><p> The easiest way to start using NLPCraft is to add Maven dependency (Grape, SBT, etc.) to your project. NLPCraft project consists of a single module.</p><nav><div class="nav nav-tabs" role="tablist"> <a class="nav-item nav-link active" data-toggle="tab" href="#nav-maven" role="tab" aria-controls="nav-home" aria-selected="true">Maven <sup>Java</sup></a> <a class="nav-item nav-link" data-toggle="tab" href="#nav-grape" role="tab" aria-controls="nav-profile" aria-selected="false">Grape <sup>Groovy</sup></a> <a class="nav-item nav-link" data-toggle="tab" href="#nav-gradle" role="tab" aria-controls="nav-profile" aria-selected="false">Gradle <sup>Kotlin</sup></a> <a class="nav-item nav-link" data-toggle="tab" href="#nav-sbt" role="tab" aria-controls="nav-contact" aria-selected="false">SBT <sup>Scala</sup></a></div></nav><div class="tab-content"><div class="tab-pane fade show active" id="nav-maven" role="tabpanel"><pre class="brush: xml">
&lt;dependency&gt;
&lt;groupId&gt;org.apache.nlpcraft&lt;/groupId&gt;
&lt;artifactId&gt;nlpcraft&lt;/artifactId&gt;
&lt;version&gt;0.5.0&lt;/version&gt;
&lt;/dependency&gt;
</pre></div><div class="tab-pane fade" id="nav-grape" role="tabpanel"><pre class="brush: java">
@Grab ('org.apache.nlpcraft:nlpcraft:0.5.0')
</pre></div><div class="tab-pane fade" id="nav-gradle" role="tabpanel"><pre class="brush: java">
dependencies {
runtime group: 'org.apache.nlpcraft', name: 'nlpcraft', version: '0.5.0'
}
</pre></div><div class="tab-pane fade" id="nav-sbt" role="tabpanel"><pre class="brush: scala">
libraryDependencies += "org.apache.nlpcraft" % "nlpcraft" % "0.5.0"
</pre></div></div><div class="bq info"><p> <b>Latest Version</b></p><p> <code>0.5.0</code> is the latest version. You can replace it with a desired version.</p></div></section><section id="github"><h2 class="section-title">GitHub</h2><p> If you want to contribute to the project or build it form the source you need to get the full developer snapshot from <a target="github" href="https://github.com/apache/incubator-nlpcraft">GitHub</a>:</p><pre class="brush: plain">
$ git clone https://github.com/apache/incubator-nlpcraft.git
$ mvn clean package
</pre><div class="bq info"><p> <b>GitHub vs. ZIP vs. Maven</b></p><p> Use GitHub clone if you want to contribute to the project or build it from source. To build your own models and integrate into your own application it is recommended to download ZIP archive or use build tools and add build dependency.</p></div></section><section id="java-client"><h2 class="section-title">Java Client <i class="fab fa-java"></i></h2><p> NLPCraft provides native Java Client for <a href="using-rest.html">REST APIs</a>. Java Client is hosted as a separate <a target="github" href="https://github.com/apache/incubator-nlpcraft-java-client">GitHub project</a> and you can add Maven dependency (Grape, SBT, etc.) to your project to start using it:</p><nav><div class="nav nav-tabs" role="tablist"> <a class="nav-item nav-link active" data-toggle="tab" href="#nav-java-client-maven" role="tab" aria-controls="nav-home" aria-selected="true">Maven <sup>Java</sup></a> <a class="nav-item nav-link" data-toggle="tab" href="#nav-java-client-grape" role="tab" aria-controls="nav-profile" aria-selected="false">Grape <sup>Groovy</sup></a> <a class="nav-item nav-link" data-toggle="tab" href="#nav-java-client-gradle" role="tab" aria-controls="nav-profile" aria-selected="false">Gradle <sup>Kotlin</sup></a> <a class="nav-item nav-link" data-toggle="tab" href="#nav-java-client-sbt" role="tab" aria-controls="nav-contact" aria-selected="false">SBT <sup>Scala</sup></a></div></nav><div class="tab-content"><div class="tab-pane fade show active" id="nav-java-client-maven" role="tabpanel"><pre class="brush: xml">
&lt;dependency&gt;
&lt;groupId&gt;org.apache.nlpcraft&lt;/groupId&gt;
&lt;artifactId&gt;nlpcraft-java-client&lt;/artifactId&gt;
&lt;version&gt;0.5.0&lt;/version&gt;
&lt;/dependency&gt;
</pre></div><div class="tab-pane fade" id="nav-java-client-grape" role="tabpanel"><pre class="brush: java">
@Grab ('org.apache.nlpcraft:nlpcraft-java-client:0.5.0')
</pre></div><div class="tab-pane fade" id="nav-java-client-gradle" role="tabpanel"><pre class="brush: java">
dependencies {
runtime group: 'org.apache.nlpcraft', name: 'nlpcraft-java-client', version: '0.5.0'
}
</pre></div><div class="tab-pane fade" id="nav-java-client-sbt" role="tabpanel"><pre class="brush: scala">
libraryDependencies += "org.apache.nlpcraft" % "nlpcraft-java-client" % "0.5.0"
</pre></div></div><div class="bq info"><p> <b>Latest Version</b></p><p> <code>0.5.0</code> is the latest Java Client version. You can replace it with a desired version.</p></div></section></div><div class="col-md-2 third-column"><ul class="side-nav"><li class="side-nav-title">On This Page<li><a href="#src">Source Release</a><li><a href="#zip">Binary Release</a><li><a href="#build">Building Binaries</a><li><a href="#verification">Verification</a><li><a href="#maven">Maven/Grape/SBT</a><li><a href="#github">GitHub</a><li><a href="#java-client">Java Client</a><li class="side-nav-title">Quick Links<li> <i class="fab fa-fw fa-github mr-2"></i><a target="github" href="https://github.com/apache/incubator-nlpcraft/tree/master/src/main/scala/org/apache/nlpcraft/examples">Examples</a><li> <i class="fab fa-fw fa-java mr-2"></i><a target="_" href="/apis/latest/index.html">Javadoc</a><li> <i class="fas fa-fw fa-code mr-2"></i><a href="https://github.com/apache/incubator-nlpcraft/blob/master/openapi/nlpcraft_swagger.yml" target="github">REST API</a><li> <i class="fas fa-fw fa-download mr-2"></i><a href="/download.html">Download</a><li class="side-nav-title">Support<li> <nobr> <i class="fab fa-fw fa-jira mr-2"></i><a target="jira" href="https://issues.apache.org/jira/projects/NLPCRAFT/issues">JIRA</a> </nobr><li> <nobr> <i class="far fa-fw fa-envelope mr-2"></i><a href="http://mail-archives.apache.org/mod_mbox/nlpcraft-dev/">Dev List</a> </nobr><li> <nobr> <i class="fab fa-fw fa-stack-overflow mr-2"></i><a target="so" href="https://stackoverflow.com/questions/ask">Stack Overflow</a> </nobr><li> <nobr> <i class="fab fa-fw fa-github mr-2"></i><a target="github" href="https://github.com/apache/incubator-nlpcraft">GitHub</a> </nobr></ul></div></div></div></div><div id="footer"><div class="container"><div class="text-muted text-center"> <span>Copyright &copy; 2020 Apache Software Foundation</span> <span> <a target=_new href="https://apache.org"><img alt="asf" src="/images/asf_logo.png" height="24px"></a> </span> <a target="asf" href="http://apache.org/foundation/policies/privacy.html" class="btn btn-link ml-4">Privacy</a> <span class="sep"></span> <a href="/index.html#news" class="btn btn-link">News</a> <span class="sep"></span> <a href="/docs.html" class="btn btn-link">Docs</a> <span class="ml-4">release: <a href="/download.html"><code>0.5.0</code></a></span> <span class="ml-2"> <a target="jenkins" href="https://builds.apache.org/view/Incubator%20Projects/job/incubator-nlpcraft/"><img src="https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fbuilds.apache.org%2Fview%2FIncubator%2520Projects%2Fjob%2Fincubator-nlpcraft%2F"></a> <a target=_ href="https://gitter.im/apache-nlpcraft/community"><img alt="Gitter" src="https://badges.gitter.im/apache-nlpcraft/community.svg"></a> </span></div></div></div><script src="//code.jquery.com/jquery-3.3.1.slim.min.js" integrity="sha384-q8i/X+965DzO0rT7abK41JStQIAqVgRVzpbzo5smXKp4YfRvH+8abtTE1Pi6jizo" crossorigin="anonymous"></script> <script src="//cdnjs.cloudflare.com/ajax/libs/popper.js/1.14.0/umd/popper.min.js" integrity="sha384-cs/chFZiN24E4KMATLdqdvsezGxaGsi4hLGOzlXwp5UZB1LY//20VyM2taTB4QvJ" crossorigin="anonymous"></script> <script src="//stackpath.bootstrapcdn.com/bootstrap/4.1.0/js/bootstrap.min.js" integrity="sha384-uefMccjFJAIv6A+rW+L4AHf99KvxDjWSu1z9VI8SKNVmz4sk7buKt/6v9KI65qnm" crossorigin="anonymous"></script> <script src="//cdnjs.cloudflare.com/ajax/libs/lodash.js/4.17.4/lodash.min.js" type="text/javascript" ></script> <script src="//cdnjs.cloudflare.com/ajax/libs/moment.js/2.12.0/moment.min.js" type="text/javascript" ></script> <script src="//cdnjs.cloudflare.com/ajax/libs/moment-timezone/0.5.5/moment-timezone-with-data.min.js" type="text/javascript" ></script> <script type="text/javascript"> SyntaxHighlighter.defaults["auto-links"] = false; SyntaxHighlighter.defaults["tab-size"] = 2; SyntaxHighlighter.all(); </script>