WasmEdge-go

README

WasmEdge for Go Package

The WasmEdge (formerly SSVM) is a high performance WebAssembly runtime optimized for server side applications. This project provides a golang package for accessing to WasmEdge.

• For a complete tutorial, please read the article Extend Your Golang App with Embedded WebAssembly Functions in WasmEdge, which demonstrates how to embed a Wasm function and how to embed a full Wasm program from the Golang app.
• WasmEdge in real-time data strems: AI Inference for Real-time Data Streams with WasmEdge and YoMo
• For more examples, please go to the WasmEdge-go-examples repo. Contributing your own example is much appreciated.

Getting Started

The WasmEdge-go requires golang version >= 1.15. Please check your golang version before installation. Developers can download golang here.

$ go version
go version go1.16.5 linux/amd64

Developers must install the WasmEdge shared library with the same WasmEdge-go release version.

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

For the developers need the TensorFlow or Image extension for WasmEdge-go, please install the WasmEdge with extensions:

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

Noticed that the TensorFlow and Image extensions are only for the Linux platforms.

Install the WasmEdge-go package and build in your Go project directory:

$ go get github.com/second-state/WasmEdge-go/wasmedge
$ go build

WasmEdge-go Extensions

By default, the WasmEdge-go only turns on the basic runtime.

WasmEdge-go has the following extensions:

• Tensorflow
  • This extension supports the host functions in WasmEdge-tensorflow.
  • For turning on this extension, the Installation of WasmEdge-tensorflow Shared Library is required.
  • For using this extension, the tag tensorflow when building is required:

    $ go build -tags tensorflow
    

• Image
  • This extension supports the host functions in WasmEdge-image.
  • For turning on this extension, the Installation of WasmEdge-image Shared Library is required.
  • For using this extension, the tag image when building is required:

    $ go build -tags image
    

Users can also turn on the multiple extensions when building:

$ go build -tags image,tensorflow

For examples, please refer to the example repository.