Start Tensorboard in Jupyter Notebook
|build-status| |pypi-status| |pypi-pyversions| |tf-versions| |docker-stars|
Tensorboard Integration for Jupyter Notebook.
A jupyter server extension for better collaboration between jupyter notebook and tensorboard (a visualization tool for tensorflow), providing graphical user interface for tensorboard start, manage and stop in jupyter interface. It provides:
pip3may be used to install the package
``pip(3) install jupyter-tensorboard``
The python version is important, you must be sure that your jupyter, jupyter_tensorboard, tensorflow have the same python version. If your tensorflow python and jupyter python versions are different, e.g., use tensorflow in py2 but jupyter starts in py3, both versions of tensorflow(py2 and py3) should be installed, and jupyter_tensorboard should install to py3, in accordance with jupyter.
Use jupyter-tensorboard in docker containers ++++++++++++++++++++++++++++++++++++++++++++
Docker image for
Jupyter Notebook Scientific Python Stack + Tensorflow + Tensorboardis available, just with the command:
.. code-block:: bash
docker pull lspvic/tensorboard-notebook docker run -it --rm -p 8888:8888 lspvic/tensorboard-notebook
Jupyter notebook with tensorboard integrated is now available in http://localhost:8888 , details are in
jupyter_tensorboardis installed and enabled, and your notebook server has been restarted, you should be able to find the interfaces to manage tensorboard instances.
tensorboardbutton will be presented. Click the button, a new browser tab will be opened to show the tensorboard interface with the proposed directory as logdir.
.. image:: https://github.com/lspvic/jupytertensorboard/raw/master/docs/static/tensorboard_button.png
newand a new tensorboard instance is started with current directory as logdir.
.. image:: https://github.com/lspvic/jupytertensorboard/raw/master/docs/static/tensorboard_menu.png
runningtab, a list of tensorboard instances are showed. Managing operations such as browsing, navigating, shutdown can be found here.
.. image:: https://github.com/lspvic/jupytertensorboard/raw/master/docs/static/tensorboard_list.png
http://jupyter-host/tensorboard//with the instance names increasing from 1.
.. image:: https://github.com/lspvic/jupytertensorboard/raw/master/docs/static/tensorboard_url.png
To purge the installation of the extension, there are a few steps to execute:
.. code:: bash
jupyter tensorboard disable --user pip uninstall jupyter-tensorboard
or if you have uninstall the pip package, but the extension seems to be not purged, you can execute:
.. code:: bash
jupyter serverextension disable jupyter_tensorboard --user jupyter nbextension disable jupyter_tensorboard/tree --user jupyter nbextension uninstall jupyter_tensorboard --user
The commands accept the same flags as the
jupyter serverextensioncommand provided by notebook versions, including
--systemto enable(or disable) in system-wide config, or
--sys-prefixto enable(or disable) in config files inside python's
sys.prefix, such as for a virtual environment.
If you encounter problems with this server extension, you can:
pip list|grep tensor, you should see at least three lines,
tensorboard). And also, check that
tensorflowversion is >=1.3.
pip list|grep notebook, you shold see
jupyter tensorboard enable --user. The step should be performed in the installation process, however, in some cases it seems that the command is not executed.
Thanks all the contributors and others for making significant contributions (report bugs, fix bugs, make enhancements, etc).
@ferrarodav_ - PR
@tcbegley_ - PR
@qrtt1_ - TF2.0 support, PR
.. |build-status| image:: https://img.shields.io/travis/lspvic/jupytertensorboard.svg :target: https://travis-ci.org/lspvic/jupytertensorboard
.. |pypi-status| image:: https://img.shields.io/pypi/v/jupytertensorboard.svg :target: https://pypi.python.org/pypi/jupytertensorboard
.. |pypi-pyversions| image:: https://img.shields.io/pypi/pyversions/jupytertensorboard.svg :target: https://pypi.python.org/pypi/jupytertensorboard
.. |tf-versions| image:: https://img.shields.io/badge/tensorflow-%E2%89%A51.3,%E2%89%A42.0-blue.svg :target: https://github.com/tensorflow/tensorflow/releases
.. |docker-stars| image:: https://img.shields.io/docker/stars/lspvic/tensorboard-notebook.svg :target: https://hub.docker.com/r/lspvic/tensorboard-notebook/