Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/zhenhuaw-me/tflite
Parse TFLite models (*.tflite) EASILY with Python. Check the API at https://zhenhuaw.me/tflite/docs/
https://github.com/zhenhuaw-me/tflite
pip tensorflow tflite
Last synced: about 16 hours ago
JSON representation
Parse TFLite models (*.tflite) EASILY with Python. Check the API at https://zhenhuaw.me/tflite/docs/
- Host: GitHub
- URL: https://github.com/zhenhuaw-me/tflite
- Owner: zhenhuaw-me
- License: apache-2.0
- Created: 2019-09-05T07:35:35.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2023-07-24T08:55:21.000Z (over 1 year ago)
- Last Synced: 2024-12-16T23:09:15.364Z (8 days ago)
- Topics: pip, tensorflow, tflite
- Language: Python
- Homepage: https://zhenhuaw.me/tflite
- Size: 15.6 MB
- Stars: 96
- Watchers: 3
- Forks: 20
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Easily Parse TFLite Models with Python
======================================![Build and Test](https://github.com/zhenhuaw-me/tflite/workflows/Build%20and%20Test/badge.svg)
[![Download](https://img.shields.io/pypi/dm/tflite)](https://img.shields.io/pypi/dm/tflite)This [`tflite` package](https://pypi.org/project/tflite/) parses TensorFlow Lite (TFLite) models (`*.tflite`), which are built by [TFLite converter](https://www.tensorflow.org/lite/convert). For background, please refer to [Introducing TFLite Parser Python Package](https://zhenhuaw.me/blog/2020/introducing-tflite-parser-package.html).
## Usage
Install the package and use it like what you build from the TensorFlow codebase.
It's recommended to install the version that same as the TensorFlow that generates the TFLite model.```sh
pip install tensorflow==2.3.0
pip install tflite==2.3.0
```The raw API of `tflite` can be found in [this documentation](https://zhenhuaw.me/tflite/docs/).
The [MobileNet test](tests/test_mobilenet.py) can serve as a usage example of parsing models.## Enhancements
The generated python package is not friendly to use sometimes.
We have introduced several enhancements:* **Easy import**: A single `import tflite` ([example](https://github.com/zhenhuaw-me/tflite/blob/master/tests/test_mobilenet.py)) to replace importing every classes and funtions in `tflite` ([example](tests/test_original_import.py)).
* **Builtin opcode helper**: The opcode is _encoded_ as digits which is hard to parse for human. Two APIs added to make it easy to use.
* [`tflite.opcode2name()`](https://github.com/zhenhuaw-me/tflite/blob/master/tflite/utils.py#L1): get the type name of given opcode.
* [`tflite.BUILTIN_OPCODE2NAME`](https://github.com/zhenhuaw-me/tflite/blob/master/tflite/utils.py#L9): a dict that maps the opcode to name of all the builtin operators.## Compatibility Handling
TensorFlow sometimes leaves compability hanlding of the TFLite model to the users.
As these are API breaking change that can be easily fixed, we do this in the `tflite` package.* [`tflite.OperatorCode.BuiltinCode()`](https://github.com/zhenhuaw-me/tflite/blob/master/tflite/OperatorCode.py#L43): maintains API compability in `2.4.0`, see [this issue](https://github.com/tensorflow/tensorflow/issues/46663).
## Contributing Updates
As the operator definition may change across different TensorFlow versions, this package needs to be updated accordingly. If you notice that the package is out of date, please feel free to contribute new versions. This is pretty simple, instructions as below.
1. [Fork the repository](https://help.github.com/en/github/getting-started-with-github/fork-a-repo), and download it.
2. Install additional depdendency via `pip install -r requirements.txt`. And install [flatbuffer compiler](https://google.github.io/flatbuffers/flatbuffers_guide_using_schema_compiler.html) (you may need to [manually build it](https://google.github.io/flatbuffers/flatbuffers_guide_building.html)).
3. Generate the code for update. Tools have been prepared, there are prompt for actions.
1. [Download](scripts/update-schema.sh) `schema.fbs` for a new version.
2. [Update](scripts/gen-op-list.py) the builtin operator mapping.
3. [Update](scripts/update-importing.py) the classes and functions import of submodules.
4. [Update](scripts/gen-doc.sh) the API document.
5. Update the versioning in [`__init__.py`](tflite/__init__.py).
6. [Build](scripts/build-wheel.sh) and [test](tests) (simply `pytest`) around. Don't forget to re-install the newly built `tflite` package before testing it.
4. Push your change and open [Pull Request](https://help.github.com/en/github/collaborating-with-issues-and-pull-requests/about-pull-requests).
5. The maintainer will take the responsibility to upload change to PyPI when merged.## Resources
* [PyPI page](https://pypi.org/project/tflite/).
* [GitHub page](https://github.com/zhenhuaw-me/tflite).
* [Module list](https://zhenhuaw.me/tflite/docs).
* [TensorFlow Lite converter](https://www.tensorflow.org/lite/convert).## License
Apache License Version 2.0 as TensorFlow's.
## Disclaimer
The `schema.fbs` is obtained from TensorFlow directly. Maintainer of this package had tried to [contact](assets/disclaimer.eml) TensorFlow maintainers for licensing issues, but received no reply. Ownership or maintainship is open to transfer or close if there were any issue.