https://github.com/meqdaddev/teachable-machine-lite
A lightweight Python package optimized for integrating exported models from Google's Teachable Machine Platform into robotics and embedded systems environments. This streamlined version of Teachable Machine Package is specifically designed for resource-constrained devices, making it easier to deploy and use your trained models in embedded apps.
https://github.com/meqdaddev/teachable-machine-lite
deep-learning deep-neural-networks image-classification machine-learning opencv opencv-python pypi pypi-package python raspberry-pi teachable-machine tensorflow tensorflow2 tensorflowlite tensorflowlite-for-microcontrollers tflite
Last synced: about 2 months ago
JSON representation
A lightweight Python package optimized for integrating exported models from Google's Teachable Machine Platform into robotics and embedded systems environments. This streamlined version of Teachable Machine Package is specifically designed for resource-constrained devices, making it easier to deploy and use your trained models in embedded apps.
- Host: GitHub
- URL: https://github.com/meqdaddev/teachable-machine-lite
- Owner: MeqdadDev
- License: mit
- Created: 2022-03-25T15:40:36.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-11-18T09:41:27.000Z (6 months ago)
- Last Synced: 2025-03-17T22:08:19.771Z (about 2 months ago)
- Topics: deep-learning, deep-neural-networks, image-classification, machine-learning, opencv, opencv-python, pypi, pypi-package, python, raspberry-pi, teachable-machine, tensorflow, tensorflow2, tensorflowlite, tensorflowlite-for-microcontrollers, tflite
- Language: Python
- Homepage: https://meqdaddev.github.io/teachable-machine-lite/
- Size: 2.66 MB
- Stars: 9
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Teachable Machine Lite
_By: [Meqdad Darwish](https://github.com/MeqdadDev)_
[](https://pepy.tech/project/teachable-machine-lite)
[](https://choosealicense.com/licenses/mit/)
[](https://pypi.org/project/teachable-machine-lite/)
## Description
A lightweight Python package optimized for integrating exported models from Google's [Teachable Machine Platform](https://teachablemachine.withgoogle.com/) into robotics and embedded systems environments. This streamlined version of [Teachable Machine Package](https://github.com/MeqdadDev/teachable-machine) is specifically designed for resource-constrained devices, making it easier to deploy and use your trained models in embedded applications. With a focus on efficiency and minimal dependencies, this tool maintains the core functionality while being more suitable for robotics and IoT projects.
Source Code is published on [GitHub](https://github.com/MeqdadDev/teachable-machine-lite/)
Read more about the project (requirements, installation, examples and more) in the [Documentation Website](https://meqdaddev.github.io/teachable-machine-lite/)
## Supported Classifiers
**Image Classification**: Use exported and quantized TensorFlow Lite model from [Teachable Machine Platform](https://teachablemachine.withgoogle.com/) (a model file with `tflite` extension).
## Requirements
For detailed information about package requirements and dependencies, please visit our [documentation](https://meqdaddev.github.io/teachable-machine-lite/requirements/)
```
Python >= 3.9
```
```
numpy < 2.0 (v1.26.4 recommended)
```
## How to install Teachable Machine Lite Package
```bash
pip install teachable-machine-lite
```
## Dependencies
```bash
numpy
tflite-runtime
Pillow
```
## Example
An example for teachable machine lite package with OpenCV:
```python
from teachable_machine_lite import TeachableMachineLite
import cv2 as cv
cap = cv.VideoCapture(0)
model_path = "model.tflite"
labels_path = "labels.txt"
image_file_name = "screenshot.jpg"
tm_model = TeachableMachineLite(model_path=model_path, labels_file_path=labels_path)
while True:
ret, img = cap.read()
cv.imwrite(image_file_name, img)
results, resultImage = tm_model.classify_and_show(image_file_name, convert_to_bgr=True)
print("results:", results)
cv.imshow("Camera", resultImage)
k = cv.waitKey(1)
if k == 27: # Press ESC to close the camera view
break
cap.release()
cv.destroyAllWindows()
```
Values of `results` are assigned based on the content of `labels.txt` file.
For more; take a look on [these examples](https://meqdaddev.github.io/teachable-machine-lite/codeExamples/)
## Links:
- [Documentation](https://meqdaddev.github.io/teachable-machine-lite)
- [PyPI](https://pypi.org/project/teachable-machine-lite/)
- [Source Code](https://github.com/MeqdadDev/teachable-machine-lite)
- [Teachable Machine Platform](https://teachablemachine.withgoogle.com/)