Find Whatsoever in image with the convenience of Machine learning at CLI!
## Basic usage
At it's core, `whatami` is a tool that allows you to identify the objects contained in an image file.
It does this by leveraging the power of the [MAX Image Segmenter model](https://developer.ibm.com/exchanges/models/all/max-image-segmenter/), one of the many free-to-use, open-source deep learning models available on [IBM's Model Asset eXchange](https://developer.ibm.com/code/exchanges/models/). The model has been converted to a [TensorFlow.js](https://tensorflow.org/js) implementation and the app runs entirely in Node.js.
In addition to displaying an image's contents, `whatami` has extended this functionality by offering several commands that allow you to search over directories with multiple images for certain objects, save individual objects as new image files, show in-terminal previews of objects, and more.
## Installation Instructions
Install using `npm` to automatically add the `whatami` command to your PATH.
~~~bash
$ npm i -g whatami
~~~
That's it!
Now you can begin using `whatami` like your very own command-line crystal ball 🔮 to identify what objects are contained in an image.
### Prerequisites
- Node.js v10.x or higher. Install from [here](https://nodejs.org/en/download/).
## Basic Commands
Keep reading for quick-and-easy install instructions, some information on the basic commands that are available and some GIFs to help you get started.
Use the basic command `whatami ` to **identify** what objects are contained in an image. If you have multiple images you'd like to inspect, you can also provide the name of a directory containing image files.
To **scan a directory** of images for a certain object, use the `--contains` command. When used in combination with the `--verbose` option, the results for all images in a directory will be displayed.
If you'd like to see an in-terminal **preview** of any of these objects, use the `--show` flag, followed by the name of the object you'd like to see. You can specify the 'colormap' to see all the objects highlighted within the original image.
To **save** any of the objects as individual image files, use the `--save` flag, followed by the name of the object you'd like to save, or use 'all' to save all objects.
To **remove** an object or background from an image, use the `--remove` flag, followed by the name of the object you'd like to remove or the shorthand aliases 'bg' or 'BG' to remove the background.
> For more detailed usage information, see the in-app **help page** which can be accessed by executing `whatami -h`
## Synopsis
~~~bash
$ whatami [--command]
$ whatami [--command]
$ whatami [--help | -h]
~~~
## Command List
| Commands | Usage |
|:-:|:-:|
| `save
