Counting 2,409 Big Data & Machine Learning Frameworks, Toolsets, and Examples...
Suggestion? Feedback? Tweet @stkim1

Project Page
Last Commit
Feb. 22, 2018
Feb. 16, 2017


Build Status codecov License

Luminoth is an open source toolkit for computer vision. Currently, we support object detection and image classification, but we are aiming for much more. It is built in Python, using TensorFlow and Sonnet.

Example of Object Detection with Faster R-CNN

DISCLAIMER: Luminoth is still alpha-quality release, which means the internal and external interfaces (such as command line) are very likely to change as the codebase matures.


Luminoth currently supports Python 2.7 and 3.4–3.6.


If you want GPU support, you should install the GPU version of TensorFlow. If TensorFlow is is already installed, Luminoth will use that version (no matter if CPU or GPU versions).

Installing Luminoth

Just install from PyPI:

$ pip install luminoth

Installing from source

First, clone the repo on your machine and then install with pip:

$ git clone
$ cd luminoth
$ pip install -e .

Check that the installation worked

Simply run lumi --help.

Supported models

Currently, we support the following models:

We are planning on adding support for more models in the near future, such as SSD, YOLO and Mask R-CNN.

Moreover, we are also working on providing pre-trained checkpoints on popular datasets such as Pascal VOC2012.


There is one main command line interface which you can use with the lumi command. Whenever you are confused on how you are supposed to do something just type:

lumi --help or lumi <subcommand> --help

and a list of available options with descriptions will show up.

Working with datasets



Check our TRAINING on how to train locally or in Google Cloud.

Visualizing results

We strive to get useful and understandable summary and graph visualizations. We consider them to be essential not only for monitoring (duh!), but for getting a broader understanding of what's going under the hood. The same way it is important for code to be understandable and easy to follow, the computation graph should be as well.

By default summary and graph logs are saved to jobs/ under the current directory. You can use TensorBoard by running:

tensorboard --logdir path/to/jobs

Why the name?

The Dark Visor is a Visor upgrade in Metroid Prime 2: Echoes. Designed by the Luminoth during the war, it was used by the Champion of Aether, A-Kul, to penetrate Dark Aether's haze in battle against the Ing.

-- Dark Visor - Wikitroid


Copyright © 2018, Tryolabs. Released under the BSD 3-Clause.

Latest Releases
 Feb. 14 2018
 Nov. 17 2017
 Oct. 10 2017