ChainerUI is a visualization and management tool for Chainer.

To install ChainerUI, use pip.

$ pip install chainerui

To install ChainerUI from source.

$ git clone https://github.com/chainer/chainerui.git
$ cd chainerui/frontend
$ npm install && npm run build && cd ..
$ pip install -e .

• ChainerUI uses sqlite3 module which is included in the standard Python library. If Python is built from source, sqlite3 must be installed before building Python.
  • On Ubuntu, "libsqlite3-dev" must be installed before building Python ($ apt-get install libsqlite3-dev).
  • On Windows, install Visual C++ Build Tools with the Default Install setting before building Python.

1. output log file with LogReport extension, see examples/log-file/train_mnist.py
2. output log file manually, see examples/log-file/train_mnist_custom_loop.py
3. post training logs via web API, see examples/web-api/train_mnist.py

Initialize ChainerUI database.

$ chainerui db create
$ chainerui db upgrade

Clone examples of train log and create a project.

$ git clone https://github.com/chainer/chainerui.git
$ cd chainerui
$ # create example project
$ chainerui project create -d examples/log-file -n example-project
$ # run ChainerUI server
$ chainerui server

Open https://localhost:5000/ and select "example-project", then shown a chart of training logs.

For more detailed usage, see getting started

Get Docker container from DockerHub and start ChainerUI server. The container has installed ChainerUI module, setup a DB and a command to start the server.

$ # replace tag to the latest version number
$ docker pull chainer/chainerui:latest
$ docker run -d -p 5000:5000 --name chainerui chainer/chainerui:latest
$ # then ChainerUI server is running

Open https://localhost:5000/, shown empty project list. examples/web-api/train_mnist.py is an example to setup project and send logs via web API.

For more detailed usage, see getting started or web API

ChainerUI is supported by the latest stable version of the following browsers.

• Firefox
• Chrome

MIT License (see LICENSE file).

Any contribution to ChainerUI is welcome!

• Python codes follow the Chainer contribution guide.

Install "pytest" package and run test

$ pytest

$ cd frontend
$ npm install
$ npm run build:watch