Jubatus をインストールして使ってみる【2017年版】

* 2017-03-30: インストール方法などを最新化しました。

----

この記事は [Jubatus Advent Calendar 2016](http://qiita.com/advent-calendar/2016/jubatus) の1日目です。

2016 年 10 月にリリースされた Jubatus 1.0 では、新機能の追加に加えて [Dockerhub での公式イメージの提供](https://hub.docker.com/r/jubatus/jubatus/tags/)が始まったため、より簡単に Jubatus を使えるようになりました。
この記事では、2016 年現在オススメの Jubatus インストール方法をまとめてみます。

# バイナリパッケージでインストールする

一番ハマリどころの少ないインストール方法です。
RHEL (CentOS) 6.x / 7.x、Ubuntu 12.04 / 14.04 / 16.04 向けの 64-bit 版パッケージが用意されています。 [^1]

[^1]: Ubuntu 12.04 は 2017 年 3 月末に [EOL](https://www.ubuntu.com/info/release-end-of-life) となります。

### RHEL / CentOS

```bash
// RHEL 6 の場合
$ sudo rpm -Uvh http://download.jubat.us/yum/rhel/6/stable/x86_64/jubatus-release-6-2.el6.x86_64.rpm
$ sudo yum install jubatus jubatus-plugin-mecab jubatus-plugin-ux
```

```bash
// RHEL 7 の場合
$ sudo rpm -Uvh http://download.jubat.us/yum/rhel/7/stable/x86_64/jubatus-release-7-2.el7.x86_64.rpm
$ sudo yum install jubatus jubatus-plugin-mecab jubatus-plugin-ux jubatus-plugin-image
```

Jubatus 1.0 まではすべてのプラグインが `jubatus` パッケージに同梱されていましたが、Jubatus 1.0 以降は必要なものだけを個別にインストールできるようになりました。
とりあえず全部入れておきましょう :)

### Ubuntu

```bash
// Ubuntu 12.04 の場合
$ echo 'deb http://download.jubat.us/apt/ubuntu/precise binary/' | sudo tee /etc/apt/sources.list.d/jubatus.list
$ sudo apt-get update
$ sudo apt-get install jubatus
```

```bash
// Ubuntu 14.04 の場合
$ echo 'deb http://download.jubat.us/apt/ubuntu/trusty binary/' | sudo tee /etc/apt/sources.list.d/jubatus.list
$ sudo apt-get update
$ sudo apt-get install jubatus
```

```bash
// Ubuntu 16.04 の場合
$ echo 'deb http://download.jubat.us/apt/ubuntu/xenial binary/' | sudo tee /etc/apt/sources.list.d/jubatus.list
$ sudo apt-get update
$ sudo apt-get install jubatus
```

# Docker でインストールする

Dockerhub から最新のイメージを取得するだけです。

```bash
$ docker pull jubatus/jubatus
```

Docker イメージの使い方は[ブログ記事](http://blog.jubat.us/2016/02/running-jubatus-on-docker.html) を参照してください。

また、裏メニューですが `jubatus/jubatus-hackathon` というイメージも用意されています。
これは先日開催された [Jubatus ハッカソン with 読売新聞 #2](http://blog.jubat.us/2016/11/3jubatusjubatus-with-2.html) 向けに用意したイメージで、Jubatus 1.0.0, 各言語のクライアント, サンプルコードなどが一式インストール済みになっています。
ちょっとお試しで使ってみる、という場合はこちらの方が便利かもしれません。

# Homebrew でインストールする

macOS 向けには [Homebrew Tap](https://github.com/jubatus/homebrew-jubatus) が提供されています。
以下のように Tap リポジトリを登録してからインストールしてください。

```bash
$ brew tap jubatus/jubatus
$ brew install jubatus --use-clang
```

# ソースからインストールする

バイナリパッケージも Docker も Homebrew も使えない場合は、ソースからビルドしてインストールすることができます。

```bash
$ cd /tmp
$ curl get.jubat.us | sh
```

を実行するか、[jubatus-installer](https://github.com/jubatus/jubatus-installer/) の `install.sh` を実行すると、ソースからのビルドが始まり、 `~/local` に Jubatus がインストールされます。 [^2]

[^2]: `install.sh` のオプションでインストール先のパスを指定することもできます。

# 一緒にインストールしておきたいツール

## jubadump

``jubadump`` コマンドを使用すると Jubatus の学習したモデルの内容 (特徴の重み情報など) を表示することができるため、特徴抽出ロジックの改善などに活用できます。

CentOS や RHEL の場合は、以下のコマンドでインストールすることができます。

```bash
$ sudo yum install jubadump
```

Ubuntu 用のパッケージにはデフォルトで ``jubadump`` コマンドが含まれています。
それ以外の環境でのインストール方法は [README](https://github.com/jubatus/jubadump) を参照してください。

## Jubakit

[Jubakit](http://jubat.us/ja/jubakit/introduction.html) は Jubatus を使ったデータ分析プログラムをより簡単に記述するための Python ライブラリです。
[scikit-learn](http://scikit-learn.org/) と連携した高度な精度検証なども行えるようになります。

```bash
pip install jubakit
```

詳しい使い方は [Jubakit の紹介スライド](http://www.slideshare.net/kmaehashi/jubakit-63202847) や [サンプルコード集](https://github.com/jubatus/jubakit/#examples-by-topics) をご覧ください。

# インストールが終わったら、使ってみよう!

ということで、[明日](http://qiita.com/advent-calendar/2016/jubatus)は @TkrUdagawa さんが Jubatus のサンプルアプリを全部動かす記事を書いてくれます。ご期待ください！