clarifai 10.2.1__py3-none-any.whl → 10.3.0__py3-none-any.whl

clarifai/utils/evaluation/main.py

@@ -0,0 +1,426 @@
+import os
+from enum import Enum
+from typing import List, Tuple, Union
+
+from clarifai.client.dataset import Dataset
+from clarifai.client.model import Model
+
+from .helpers import (MACRO_AVG, EvalType, _BaseEvalResultHandler, get_eval_type,
+                      make_handler_by_type)
+
+try:
+  import seaborn as sns
+except ImportError:
+  raise ImportError("Can not import seaborn. Please run `pip install seaborn` to install it")
+
+try:
+  import matplotlib.pyplot as plt
+except ImportError:
+  raise ImportError("Can not import matplotlib. Please run `pip install matplotlib` to install it")
+
+try:
+  import pandas as pd
+except ImportError:
+  raise ImportError("Can not import pandas. Please run `pip install pandas` to install it")
+
+try:
+  from loguru import logger
+except ImportError:
+  from ..logging import get_logger
+  logger = get_logger(logger_level="INFO", name=__name__)
+
+__all__ = ['EvalResultCompare']
+
+
+class CompareMode(Enum):
+  MANY_MODELS_TO_ONE_DATA = 0
+  ONE_MODEL_TO_MANY_DATA = 1
+
+
+class EvalResultCompare:
+  """Compare evaluation result of models against datasets.
+  Note: The module will pick latest result on the datasets.
+  and models must be same model type
+
+  Args:
+  ---
+    models (Union[List[Model], List[str]]): List of Model or urls of models.
+    datasets (Union[Dataset, List[Dataset], str, List[str]]): A single or List of Url or Dataset
+    attempt_evaluate (bool): Evaluate when model is not evaluated with the datasets.
+    auth_kwargs (dict): Additional auth keyword arguments to be passed to the Dataset and Model if using url(s)
+  """
+
+  def __init__(self,
+               models: Union[List[Model], List[str]],
+               datasets: Union[Dataset, List[Dataset], str, List[str]],
+               attempt_evaluate: bool = False,
+               auth_kwargs: dict = {}):
+    assert isinstance(models, list), ValueError("Expected list")
+
+    if len(models) > 1:
+      self.mode = CompareMode.MANY_MODELS_TO_ONE_DATA
+      self.comparator = "Model"
+      assert isinstance(datasets, Dataset) or (
+          isinstance(datasets, list) and len(datasets) == 1
+      ), f"When comparing multiple models, must provide only one `datasets`. However got {datasets}"
+    else:
+      self.mode = CompareMode.ONE_MODEL_TO_MANY_DATA
+      self.comparator = "Dataset"
+
+    # validate models
+    if all(map(lambda x: isinstance(x, str), models)):
+      models = [Model(each, **auth_kwargs) for each in models]
+    elif not all(map(lambda x: isinstance(x, Model), models)):
+      raise ValueError(
+          f"Expected all models are list of string or list of Model, got {[type(each) for each in models]}"
+      )
+    # validate datasets
+    if not isinstance(datasets, list):
+      datasets = [
+          datasets,
+      ]
+    if all(map(lambda x: isinstance(x, str), datasets)):
+      datasets = [Dataset(each, **auth_kwargs) for each in datasets]
+    elif not all(map(lambda x: isinstance(x, Dataset), datasets)):
+      raise ValueError(
+          f"Expected datasets must be str, list of string or Dataset, list of Dataset, got {[type(each) for each in datasets]}"
+      )
+    # Validate models vs datasets together
+    self._eval_handlers: List[_BaseEvalResultHandler] = []
+    self.model_type = None
+    logger.info("Initializing models...")
+    for model in models:
+      model.load_info()
+      model_type = model.model_info.model_type_id
+      if not self.model_type:
+        self.model_type = model_type
+      else:
+        assert self.model_type == model_type, f"Can not compare when model types are different, {self.model_type} != {model_type}"
+      m = make_handler_by_type(model_type)(model=model)
+      logger.info(f"* {m.get_model_name(pretify=True)}")
+      m.find_eval_id(datasets=datasets, attempt_evaluate=attempt_evaluate)
+      self._eval_handlers.append(m)
+
+  @property
+  def eval_handlers(self):
+    return self._eval_handlers
+
+  def _loop_eval_handlers(self, func_name: str, **kwargs) -> Tuple[list, list]:
+    """ Run methods of `eval_handlers[...].model`
+
+    Args:
+      func_name (str): method name, see `_BaseEvalResultHandler` child classes
+      kwargs: keyword arguments of the method
+
+    Return:
+      tuple:
+        - list of outputs
+        - list of comparator names
+
+    """
+    outs = []
+    comparators = []
+    logger.info(f'Running `{func_name}`')
+    for _, each in enumerate(self.eval_handlers):
+      for ds_index, _ in enumerate(each.eval_data):
+        func = eval(f'each.{func_name}')
+        out = func(index=ds_index, **kwargs)
+
+        if self.mode == CompareMode.MANY_MODELS_TO_ONE_DATA:
+          name = each.get_model_name(pretify=True)
+        else:
+          name = each.get_dataset_name_by_index(ds_index, pretify=True)
+        if out is None:
+          logger.warning(f'{self.comparator}:{name} does not have valid data for `{func_name}`')
+          continue
+        comparators.append(name)
+        outs.append(out)
+
+    if self.mode == CompareMode.MANY_MODELS_TO_ONE_DATA:
+      apps = set([comp.split('/')[0] for comp in comparators])
+      if len(apps) == 1:
+        comparators = ['/'.join(comp.split('/')[1:]) for comp in comparators]
+
+    if not outs:
+      logger.warning(f'Model type {self.model_type} does not support `{func_name}`')
+
+    return outs, comparators
+
+  def detailed_summary(self,
+                       confidence_threshold: float = .5,
+                       iou_threshold: float = .5,
+                       area: str = "all",
+                       bypass_const=False) -> Union[Tuple[pd.DataFrame, pd.DataFrame], None]:
+    """
+    Retrieve and compute popular metrics of model.
+
+    Args:
+      confidence_threshold (float): confidence threshold, applicable for classification and detection. Default is 0.5
+      iou_threshold (float): iou threshold, support in range(0.5, 1., step=0.1) applicable for detection
+      area (float): size of area, support {all, small, medium}, applicable for detection
+
+    Return:
+      None or tuple of dataframe: df summary per concept and total concepts
+
+    """
+    df = []
+    total = []
+    # loop over all eval_handlers/dataset and call its method
+    outs, comparators = self._loop_eval_handlers(
+        'detailed_summary',
+        confidence_threshold=confidence_threshold,
+        iou_threshold=iou_threshold,
+        area=area,
+        bypass_const=bypass_const)
+    for indx, out in enumerate(outs):
+      _df, _total = out
+      _df[self.comparator] = [comparators[indx] for _ in range(len(_df))]
+      _total['Concept'].replace(
+          to_replace=['Total'], value=f'{self.comparator}:{comparators[indx]}', inplace=True)
+      _total.rename({'Concept': 'Total Concept'}, axis=1, inplace=True)
+      df.append(_df)
+      total.append(_total)
+
+    if df:
+      df = pd.concat(df, axis=0)
+      total = pd.concat(total, axis=0)
+      return df, total
+    else:
+      return None
+
+  def confusion_matrix(self, show=True, save_path: str = None,
+                       cm_kwargs: dict = {}) -> Union[pd.DataFrame, None]:
+    """Return dataframe of confusion matrix
+    Args:
+        show (bool, optional): Show the chart. Defaults to True.
+        save_path (str): path to save rendered chart.
+        cm_kwargs (dict): keyword args of `eval_handler[...].model.cm_kwargs` method.
+    Returns:
+        None or pd.Dataframe, If models don't have confusion matrix, return None
+    """
+    outs, comparators = self._loop_eval_handlers("confusion_matrix", **cm_kwargs)
+    all_dfs = []
+    for _, (df, anchor) in enumerate(zip(outs, comparators)):
+      df[self.comparator] = [anchor for _ in range(len(df))]
+      all_dfs.append(df)
+
+    if all_dfs:
+      all_dfs = pd.concat(all_dfs, axis=0)
+      if save_path or show:
+
+        def _facet_heatmap(data, **kws):
+          data = data.dropna(axis=1)
+          data = data.drop(self.comparator, axis=1)
+          concepts = data.columns
+          colnames = pd.MultiIndex.from_arrays([concepts], names=['Predicted'])
+          data.columns = colnames
+          ax = sns.heatmap(data, cmap='Blues', annot=True, annot_kws={"fontsize": 8}, **kws)
+          ax.set_xticklabels(ax.get_xticklabels(), rotation=45, fontsize=6)
+          ax.set_yticklabels(ax.get_yticklabels(), fontsize=6, rotation=0)
+
+        temp = all_dfs.copy()
+        temp.columns = ["_".join(pair) for pair in temp.columns]
+        with sns.plotting_context(font_scale=5.5):
+          g = sns.FacetGrid(
+              temp,
+              col=self.comparator,
+              col_wrap=3,
+              aspect=1,
+              height=3,
+              sharex=False,
+              sharey=False,
+          )
+          cbar_ax = g.figure.add_axes([.92, .3, .02, .4])
+          g = g.map_dataframe(
+              _facet_heatmap, cbar_ax=cbar_ax, vmin=0, vmax=1, cbar=True, square=True)
+          g.set_titles(col_template=str(self.comparator) + ':{col_name}', fontsize=5)
+          if show:
+            plt.show()
+          if save_path:
+            g.savefig(save_path)
+
+    return all_dfs if isinstance(all_dfs, pd.DataFrame) else None
+
+  @staticmethod
+  def _set_default_kwargs(kwargs: dict, var_name: str, value):
+    if var_name not in kwargs:
+      kwargs.update({var_name: value})
+    return kwargs
+
+  @staticmethod
+  def _setup_default_lineplot(df: pd.DataFrame, kwargs: dict):
+    hue_order = df["concept"].unique().tolist()
+    hue_order.remove(MACRO_AVG)
+    hue_order.insert(0, MACRO_AVG)
+    EvalResultCompare._set_default_kwargs(kwargs, "hue_order", hue_order)
+
+    sizes = {}
+    for each in hue_order:
+      s = 1.5
+      if each == MACRO_AVG:
+        s = 4.
+      sizes.update({each: s})
+    EvalResultCompare._set_default_kwargs(kwargs, "sizes", sizes)
+    EvalResultCompare._set_default_kwargs(kwargs, "size", "concept")
+
+    EvalResultCompare._set_default_kwargs(kwargs, "errorbar", None)
+    EvalResultCompare._set_default_kwargs(kwargs, "height", 5)
+
+    return kwargs
+
+  def roc_curve_plot(self,
+                     show=True,
+                     save_path: str = None,
+                     roc_curve_kwargs: dict = {},
+                     relplot_kwargs: dict = {}) -> Union[pd.DataFrame, None]:
+    """Return dataframe of ROC curve
+    Args:
+        show (bool, optional): Show the chart. Defaults to True.
+        save_path (str): path to save rendered chart.
+        pr_curve_kwargs (dict): keyword args of `eval_handler[...].model.roc_curve` method.
+        relplot_kwargs (dict): keyword args of `sns.relplot` except {data,x,y,hue,kind,col}. where x="fpr", y="tpr", hue="concept"
+    Returns:
+        None or pd.Dataframe, If models don't have ROC curve, return None
+    """
+    sns.set_palette("Paired")
+    outs, comparator = self._loop_eval_handlers("roc_curve", **roc_curve_kwargs)
+    all_dfs = []
+    for _, (df, anchor) in enumerate(zip(outs, comparator)):
+      df[self.comparator] = [anchor for _ in range(len(df))]
+      all_dfs.append(df)
+
+    if all_dfs:
+      all_dfs = pd.concat(all_dfs, axis=0)
+      if save_path or show:
+        relplot_kwargs = self._setup_default_lineplot(all_dfs, relplot_kwargs)
+        g = sns.relplot(
+            data=all_dfs,
+            x="fpr",
+            y="tpr",
+            hue='concept',
+            kind="line",
+            col=self.comparator,
+            **relplot_kwargs)
+        g.set_titles(col_template=str(self.comparator) + ':{col_name}', fontsize=5)
+        if show:
+          plt.show()
+        if save_path:
+          g.savefig(save_path)
+
+    return all_dfs if isinstance(all_dfs, pd.DataFrame) else None
+
+  def pr_plot(self,
+              show=True,
+              save_path: str = None,
+              pr_curve_kwargs: dict = {},
+              relplot_kwargs: dict = {}) -> Union[pd.DataFrame, None]:
+    """Return dataframe of PR curve
+    Args:
+        show (bool, optional): Show the chart. Defaults to True.
+        save_path (str): path to save rendered chart.
+        pr_curve_kwargs (dict): keyword args of `eval_handler[...].model.pr_curve` method.
+        relplot_kwargs (dict): keyword args of `sns.relplot` except {data,x,y,hue,kind,col} where x="recall", y="precision", hue="concept"
+    Returns:
+        None or pd.Dataframe, If models don't have PR curve, return None
+    """
+    sns.set_palette("Paired")
+    outs, comparator = self._loop_eval_handlers("pr_curve", **pr_curve_kwargs)
+    all_dfs = []
+    for _, (df, anchor) in enumerate(zip(outs, comparator)):
+      df[self.comparator] = [anchor for _ in range(len(df))]
+      all_dfs.append(df)
+
+    if all_dfs:
+      all_dfs = pd.concat(all_dfs, axis=0)
+      if save_path or show:
+        relplot_kwargs = self._setup_default_lineplot(all_dfs, relplot_kwargs)
+        g = sns.relplot(
+            data=all_dfs,
+            x="recall",
+            y="precision",
+            hue='concept',
+            kind="line",
+            col=self.comparator,
+            **relplot_kwargs)
+        g.set_titles(col_template=str(self.comparator) + ':{col_name}', fontsize=5)
+        if show:
+          plt.show()
+        if save_path:
+          g.savefig(save_path)
+
+    return all_dfs if isinstance(all_dfs, pd.DataFrame) else None
+
+  def all(
+      self,
+      output_folder: str,
+      confidence_threshold: float = 0.5,
+      iou_threshold: float = 0.5,
+      overwrite: bool = False,
+      metric_kwargs: dict = {},
+      pr_plot_kwargs: dict = {},
+      roc_plot_kwargs: dict = {},
+  ):
+    """Run all comparison methods one by one:
+    - detailed_summary
+    - pr_curve (if applicable)
+    - pr_plot
+    - confusion_matrix (if applicable)
+    And save to output_folder
+
+    Args:
+      output_folder (str): path to output
+      confidence_threshold (float): confidence threshold, applicable for classification and detection. Default is 0.5.
+      iou_threshold (float): iou threshold, support in range(0.5, 1., step=0.1) applicable for detection.
+      overwrite (bool): overwrite result of output_folder.
+      metric_kwargs (dict): keyword args for `eval_handler[...].model.{method}`, except for {confidence_threshold, iou_threshold}.
+      roc_plot_kwargs (dict): for relplot_kwargs of `roc_curve_plot` method.
+      pr_plot_kwargs (dict): for relplot_kwargs of `pr_plot` method.
+    """
+    eval_type = get_eval_type(self.model_type)
+    area = metric_kwargs.pop("area", "all")
+    bypass_const = metric_kwargs.pop("bypass_const", False)
+
+    fname = f"conf-{confidence_threshold}"
+    if eval_type == EvalType.DETECTION:
+      fname = f"{fname}_iou-{iou_threshold}_area-{area}"
+
+    def join_root(*args):
+      return os.path.join(output_folder, *args)
+
+    output_folder = join_root(fname)
+    if os.path.exists(output_folder) and not overwrite:
+      raise RuntimeError(f"{output_folder} exists. If you want to overwrite, set `overwrite=True`")
+
+    os.makedirs(output_folder, exist_ok=True)
+
+    logger.info("Making summary tables...")
+    dfs = self.detailed_summary(
+        confidence_threshold=confidence_threshold,
+        iou_threshold=iou_threshold,
+        area=area,
+        bypass_const=bypass_const)
+    if dfs is not None:
+      concept_df, total_df = dfs
+      concept_df.to_csv(join_root("concepts_summary.csv"))
+      total_df.to_csv(join_root("total_summary.csv"))
+
+    curve_metric_kwargs = dict(
+        confidence_threshold=confidence_threshold, iou_threshold=iou_threshold)
+    curve_metric_kwargs.update(metric_kwargs)
+
+    self.roc_curve_plot(
+        show=False,
+        save_path=join_root("roc.jpg"),
+        roc_curve_kwargs=curve_metric_kwargs,
+        relplot_kwargs=roc_plot_kwargs)
+
+    self.pr_plot(
+        show=False,
+        save_path=join_root("pr.jpg"),
+        pr_curve_kwargs=curve_metric_kwargs,
+        relplot_kwargs=pr_plot_kwargs)
+
+    self.confusion_matrix(
+        show=False, save_path=join_root("confusion_matrix.jpg"), cm_kwargs=curve_metric_kwargs)
+
+    logger.info(f"Done. Your outputs are saved at {output_folder}")

clarifai/utils/evaluation/testset_annotation_parser.py

@@ -0,0 +1,150 @@
+from typing import List, Tuple
+import numpy as np
+from clarifai_grpc.grpc.api import resources_pb2 as respb2
+
+
+def parse_eval_annotation_classifier(
+    eval_metrics: respb2.EvalMetrics) -> Tuple[np.array, np.array, list, List[respb2.Input]]:
+  test_set = eval_metrics.test_set
+  # get concept ids
+  concept_ids = [each.id for each in test_set[0].predicted_concepts]
+  concept_ids.sort()
+  # get test set
+  y_preds = []
+  y = []
+  inputs = []
+  for data in test_set:
+
+    def _to_array(_data):
+      cps = [0] * len(concept_ids)
+      for each in _data:
+        cps[concept_ids.index(each.id)] = each.value
+      return np.asarray(cps)
+
+    y_preds.append(_to_array(data.predicted_concepts))
+    y.append(_to_array(data.ground_truth_concepts))
+    inputs.append(data.input)
+
+  return np.asarray(y), np.asarray(y_preds), concept_ids, inputs
+
+
+def parse_eval_annotation_detector(eval_metrics: respb2.EvalMetrics,
+                                   normalized_box: bool = False,
+                                   box_style: str = "xyxy"
+                                  ) -> Tuple[np.array, np.array, list, List[respb2.Input]]:
+  BOX_STYLES = ["xyxy", "xywh"]
+  assert box_style in BOX_STYLES, ValueError(f"Expected box_style in {BOX_STYLES}")
+
+  concept_ids = list(set([each.concept.id for each in eval_metrics.metrics_by_class]))
+  concept_ids.sort()
+
+  def _get_box_annot(field, img_height, img_width):
+    xyxy_concept_score = []
+    for each in field:
+      box = each.region_info.bounding_box
+      x1 = box.left_col * img_width
+      y1 = box.top_row * img_height
+      x2 = box.right_col * img_width
+      y2 = box.bottom_row * img_height
+      score = each.data.concepts[0].value
+      concept = each.data.concepts[0].id
+      concept_index = concept_ids.index(concept)
+      if box_style == "xyxy":
+        xyxy_concept_score.append([x1, y1, x2, y2, concept_index, score])
+      else:
+        w = abs(x1 - x2)
+        h = abs(y1 - y2)
+        xyxy_concept_score.append([x1, y1, w, h, concept_index, score])
+
+    return np.asarray(xyxy_concept_score)
+
+  inputs = []
+  pred_xyxy_concept_score = []
+  gt_xyxy_concept_score = []
+  for input_data in eval_metrics.test_set:
+    _input = input_data.input
+    img_height = _input.data.image.image_info.height if not normalized_box else 1.
+    img_width = _input.data.image.image_info.height if not normalized_box else 1.
+    _pred_xyxy_concept_score = _get_box_annot(
+        input_data.predicted_annotation.data.regions, img_height=img_height, img_width=img_width)
+    _gt_xyxy_concept_score = _get_box_annot(
+        input_data.ground_truth_annotation.data.regions,
+        img_height=img_height,
+        img_width=img_width)
+
+    pred_xyxy_concept_score.append(_pred_xyxy_concept_score)
+    gt_xyxy_concept_score.append(_gt_xyxy_concept_score)
+    inputs.append(_input)
+
+  return np.asarray(gt_xyxy_concept_score), np.asarray(
+      pred_xyxy_concept_score), concept_ids, inputs
+
+
+def parse_eval_annotation_detector_coco(eval_metrics: respb2.EvalMetrics,
+                                       ) -> Tuple[np.array, np.array, list, List[respb2.Input]]:
+
+  gts, preds, concept_ids, inputs = parse_eval_annotation_detector(
+      eval_metrics=eval_metrics, normalized_box=False, box_style="xywh")
+
+  def _make_box_annot(data, input_data, accum_id, is_pred=True):
+    img_id = input_data.id
+    img_url = input_data.data.image.url
+    img_height = input_data.data.image.image_info.height
+    img_width = input_data.data.image.image_info.height
+    image = {
+        "id": img_id,
+        "file_name": img_url,
+        "width": img_width,
+        "height": img_height,
+    }
+    annotations = []
+    for i, d in enumerate(data.tolist()):
+      area = d[2] * d[3]
+      box = {
+          "iscrowd": 0,
+          "ignore": 0,
+          "image_id": img_id,
+          "bbox": d[:4],
+          "area": area,
+          "segmentation": [],
+          "category_id": d[4],
+          "id": accum_id + i,
+      }
+      if is_pred:
+        box["score"] = d[5]
+      annotations.append(box)
+
+    return image, annotations
+
+  categories = [{
+      "supercategory": "none",
+      "id": i,
+      "name": label
+  } for i, label in enumerate(concept_ids)]
+
+  accum_pred_ids = 0
+  accum_gt_ids = 0
+  pred_images = []
+  pred_boxes = []
+  gt_images = []
+  gt_boxes = []
+  for ith, input_proto in enumerate(inputs):
+    pred = preds[ith]
+    gt = gts[ith]
+    pred_img, pred_box = _make_box_annot(
+        pred, accum_id=accum_pred_ids, input_data=input_proto, is_pred=True)
+    gt_img, gt_box = _make_box_annot(
+        gt, accum_id=accum_gt_ids, input_data=input_proto, is_pred=False)
+
+    accum_pred_ids += len(pred)
+    pred_images.append(pred_img)
+    pred_boxes += pred_box
+
+    accum_gt_ids += len(gt)
+    gt_images.append(gt_img)
+    gt_boxes += gt_box
+
+  pred_annots = {"images": pred_images, "annotations": pred_boxes, "categories": categories}
+  gt_annots = {"images": gt_images, "annotations": gt_boxes, "categories": categories}
+
+  return gt_annots, pred_annots

clarifai/versions.py

@@ -1,6 +1,6 @@
 import os
 
-CLIENT_VERSION = "10.2.1"
+CLIENT_VERSION = "10.3.0"
 OS_VER = os.sys.platform
 PYTHON_VERSION = '.'.join(
     map(str, [os.sys.version_info.major, os.sys.version_info.minor, os.sys.version_info.micro]))

{clarifai-10.2.1.dist-info → clarifai-10.3.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: clarifai
-Version: 10.2.1
+Version: 10.3.0
 Summary: Clarifai Python SDK
 Home-page: https://github.com/Clarifai/clarifai-python
 Author: Clarifai
@@ -20,18 +20,18 @@ Classifier: Operating System :: OS Independent
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: clarifai-grpc (~=10.2.1)
-Requires-Dist: numpy (>=1.22.0)
-Requires-Dist: tqdm (>=4.65.0)
-Requires-Dist: tritonclient (>=2.34.0)
-Requires-Dist: rich (>=13.4.2)
-Requires-Dist: PyYAML (>=6.0.1)
-Requires-Dist: schema (>=0.7.5)
-Requires-Dist: Pillow (>=9.5.0)
-Requires-Dist: inquirerpy (==0.3.4)
-Requires-Dist: tabulate (>=0.9.0)
+Requires-Dist: clarifai-grpc ~=10.2.3
+Requires-Dist: numpy >=1.22.0
+Requires-Dist: tqdm >=4.65.0
+Requires-Dist: tritonclient >=2.34.0
+Requires-Dist: rich >=13.4.2
+Requires-Dist: PyYAML >=6.0.1
+Requires-Dist: schema >=0.7.5
+Requires-Dist: Pillow >=9.5.0
+Requires-Dist: inquirerpy ==0.3.4
+Requires-Dist: tabulate >=0.9.0
 Provides-Extra: all
-Requires-Dist: pycocotools (==2.0.6) ; extra == 'all'
+Requires-Dist: pycocotools ==2.0.6 ; extra == 'all'
 
 <h1 align="center">
   <a href="https://www.clarifai.com/"><img alt="Clarifai" title="Clarifai" src="https://upload.wikimedia.org/wikipedia/commons/b/bc/Clarifai_Logo_FC_Web.png"></a>