Skip to content

Latest commit

 

History

History
159 lines (114 loc) · 4.71 KB

README.md

File metadata and controls

159 lines (114 loc) · 4.71 KB
Raw

Streaming Image Recognition by WebAssembly

Youtube: YoMo x WasmEdge

This project demonstrates how to process a video stream in real-time using WebAssembly and apply a pre-trained food classification model to each frame of the video in order to determine if food is present in that frame, all by integrating WasmEdge into YoMo serverless.

Open-source projects that we used:

  • Serverless stream processing framework YoMo
  • Integrate with WasmEdge to introduce WebAssembly, interop TensorFlow Lite model
  • A deep learning model found on TensorFlow Hub; make sure to download TFLite (aiy/vision/classifier/food_V1), which was created by Google

Advantages:

  • ⚡️ Low-latency: Streaming data processing applications can now be done in far edge data centers thanks to YoMo's highly efficient network services
  • 🔐 Security: WasmEdge runs the data processing function in a WebAssembly sandbox for isolation, safety, and hot deployment
  • 🚀 High Performance: Compared with popular containers, such as Docker, WasmEdge can be up to 100x faster at startup and have a much smaller footprint
  • 🎯 Edge Devices: As WasmEdge consumes much less resources than Docker, it is now possible to run data processing applications on edge devices

Steps to run

1. Clone This Repository

$ git clone https://github.com/yomorun/yomo-wasmedge-tensorflow.git

2. Install YoMo CLI

$ curl -fsSL "https://get.yomo.run" | sh
$ yomo version
YoMo CLI version: v1.13.0

Details about YoMo CLI installation can be found here.

3. Install WasmEdge Dependencies

Install WasmEdge with its Tensorflow and image processing extensions

wget -qO- https://raw.githubusercontent.com/WasmEdge/WasmEdge/master/utils/install.sh | bash -s -- -e all -p /usr/local

If you have any questions about installation, please refer to the official documentation. Currently, this project works on Linux machines only.

Install video and image processing dependencies

$ sudo apt-get update
$ sudo apt-get install -y ffmpeg libjpeg-dev libpng-dev

4. Write your Streaming Serverless function

Write app.go to integrate WasmEdge-tensorflow:

  • Get WasmEdge-go:

    $ cd flow
$ go get -u github.com/second-state/WasmEdge-go/wasmedge

  • download the pretrained model file lite-model_aiy_vision_classifier_food_V1_1.tflite，and store to rust_mobilenet_food/src directory:

    $ wget 'https://storage.googleapis.com/tfhub-lite-models/google/lite-model/aiy/vision/classifier/food_V1/1.tflite' -O ./rust_mobilenet_food/src/lite-model_aiy_vision_classifier_food_V1_1.tflite

  • install rustc and cargo

    $ curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
$ export PATH=$PATH:$HOME/.cargo/bin
$ rustc --version

  • install wasm32-wasi target

    $ rustup target add wasm32-wasi

  • compile wasm file

    $ cd rust_mobilenet_food
$ cargo build --release --target wasm32-wasi
# The output WASM will be `target/wasm32-wasi/release/rust_mobilenet_food_lib.wasm`.
$ cd ..

  • copy the compiled wasm file

    $ cp rust_mobilenet_food/target/wasm32-wasi/release/rust_mobilenet_food_lib.wasm .

  • optional: compile wasm file to AOT mode

    wasmedgec rust_mobilenet_food_lib.wasm rust_mobilenet_food_lib.so

5. Run YoMo Zipper Server

$ yomo serve -c ./zipper/config.yaml

6. Run Streaming Serverless function

$ cd flow
$ go run -tags tensorflow,image app.go

7. Demonstrate video stream

Download this demo video: hot-dog.mp4, and store to source directory：

$ wget -P source 'https://github.com/yomorun/yomo-wasmedge-tensorflow/releases/download/v0.2.0/hot-dog.mp4'

then run：

$ go run ./source/main.go ./source/hot-dog.mp4

8. Result

YoMo-WasmEdge