lucario

https://github.com/lucario-2004/lucario

Repository

README.rst

Hailo Model Zoo
===============

.. |python| image:: https://img.shields.io/badge/python-3.8%20%7C%203.9%20%7C%203.10-blue.svg
   :target: https://www.python.org/downloads/release/python-380/
   :alt: Python 3.8
   :width: 150
   :height: 20


.. |tensorflow| image:: https://img.shields.io/badge/Tensorflow-2.12.0-blue.svg
   :target: https://github.com/tensorflow/tensorflow/releases/tag/v2.12.0
   :alt: Tensorflow
   :width: 110
   :height: 20


.. |cuda| image:: https://img.shields.io/badge/CUDA-11.8-blue.svg
   :target: https://developer.nvidia.com/cuda-toolkit
   :alt: Cuda
   :width: 80
   :height: 20


.. |compiler| image:: https://img.shields.io/badge/Hailo%20Dataflow%20Compiler-3.28.0-brightgreen.svg
   :target: https://hailo.ai/company-overview/contact-us/
   :alt: Hailo Dataflow Compiler
   :width: 180
   :height: 20


.. |runtime| image:: https://img.shields.io/badge/HailoRT%20(optional)-4.18.0-brightgreen.svg
   :target: https://hailo.ai/company-overview/contact-us/
   :alt: HailoRT
   :width: 170
   :height: 20


.. |license| image:: https://img.shields.io/badge/License-MIT-yellow.svg
   :target: https://github.com/hailo-ai/hailo_model_zoo/blob/master/LICENSE
   :alt: License: MIT
   :width: 80
   :height: 20


.. image:: docs/images/logo.png

|python| |tensorflow| |cuda| |compiler| |runtime| |license|


The Hailo Model Zoo provides pre-trained models for high-performance deep learning applications. Using the Hailo Model Zoo you can measure the full precision accuracy of each model, the quantized accuracy using the Hailo Emulator and measure the accuracy on the Hailo-8 device. Finally, you will be able to generate the Hailo Executable Format (HEF) binary file to speed-up development and generate high quality applications accelerated with Hailo-8. The Hailo Model Zoo also provides re-training instructions to train the models on custom datasets and models that were trained for specific use-cases on internal datasets.

Models
Hailo provides different pre-trained models in ONNX / TF formats and pre-compiled HEF (Hailo Executable Format) binary file to execute on the Hailo devices.

The models are divided to:

* Public models - which were trained on publicly available datasets.

    * For Hailo-8 - `Classification `_, `Object Detection `_, `Segmentation `_, `other tasks `_

    * For Hailo-8L - `Classification `_, `Object Detection `_, `Segmentation `_, `other tasks `_

    * For Hailo-15H - `Classification `_, `Object Detection `_, `Segmentation `_, `other tasks `_

    * For Hailo-15M - `Classification `_, `Object Detection `_, `Segmentation `_, `other tasks `_

    * For Hailo-10 - `Classification `_, `Object Detection `_, `Segmentation `_, `other tasks `_



* | `HAILO MODELS `_ which were trained in-house for specific use-cases on internal datasets.
  | Each Hailo Model is accompanied with retraining instructions.


Retraining
----------

Hailo also provides `RETRAINING INSTRUCTIONS `_ to train a network from the Hailo Model Zoo with custom dataset.

Benchmarks
----------

| List of Hailo's benchmarks can be found in `hailo.ai `_.
| In order to reproduce the measurements please refer to the following `page `_.


Quick Start Guide
------------------


* Install Hailo Dataflow Compiler and enter the virtualenv. In case you are not Hailo customer please contact `hailo.ai `_
* Install HailoRT (optional). Required only if you want to run on Hailo-8. In case you are not Hailo customer please contact `hailo.ai `_
* Clone the Hailo Model Zoo


  .. code-block::

      git clone https://github.com/hailo-ai/hailo_model_zoo.git

* Run the setup script


  .. code-block::

     cd hailo_model_zoo; pip install -e .

* Run the Hailo Model Zoo. For example, print the information of the MobileNet-v1 model:


  .. code-block::

     hailomz info mobilenet_v1

Getting Started
^^^^^^^^^^^^^^^

For full functionality please see the `INSTALLATION GUIDE `_ page (full install instructions and usage examples). The Hailo Model Zoo is using the Hailo Dataflow Compiler for parsing, model optimization, emulation and compilation of the deep learning models. Full functionality includes:


* | Parse: model translation of the input model into Hailo's internal representation.
* | Profiler: generate profiler report of the model. The report contains information about your model and expected performance on the Hailo hardware.
* | Optimize: optimize the deep learning model for inference and generate a numeric translation of the input model into a compressed integer representation.
  | For further information please see our `OPTIMIZATION `_ page.
* | Compile: run the Hailo compiler to generate the Hailo Executable Format file (HEF) which can be executed on the Hailo hardware.
* | Evaluate: infer the model using the Hailo Emulator or the Hailo hardware and produce the model accuracy.

For further information about the Hailo Dataflow Compiler please contact `hailo.ai `_.


.. figure:: docs/images/usage_flow.svg


License
-------

The Hailo Model Zoo is released under the MIT license. Please see the `LICENSE `_ file for more information.

Support & Issues
----------------

⚠️ **Issue reporting is disabled in this repository.**

For bug reports, feature requests, or discussions, please visit our `Hailo Community Forum `_.

Changelog
---------

For further information please see our `CHANGELOG `_ page.

Owner

Citation (CITATION.cff)

# This CITATION.cff file was generated with cffinit.
# Visit https://bit.ly/cffinit to generate yours today!

cff-version: 1.2.0
title: Hailo Model Zoo
message: >-
  If you use Hailo in your research, please cite this
  repository using these metadata.
type: software
authors:
  - given-names: Tamir
    family-names: Tapuhi
    email: tamirt@hailo.ai
  - given-names: Shachar
    family-names: Gluska
    email: shacharg@hailo.ai
  - given-names: Amit
    family-names: Klinger
    email: amitk@hailo.ai
  - given-names: Nadiv
    family-names: Dharan
    email: nadivd@hailo.ai
  - given-names: Omer
    family-names: Sholev
    email: omersh@hailo.ai
  - given-names: Yuval
    family-names: Zelig
    email: yuvalz@hailo.ai
  - given-names: Niv
    family-names: Vosco
    email: nivv@hailo.ai
repository-code: 'https://github.com/hailo-ai/hailo_model_zoo'
url: 'https://hailo.ai/products/hailo-software-suite/model-zoo/'
abstract: >-
  The Hailo Model Zoo includes pre-trained models and a full
  building and evaluation environment
license: MIT
date-released: '2021-07-01'

GitHub Events