second-state / wasmedge-rustsdk-examples

Examples of WasmEdge Rust SDK

All examples have been verified on Ubuntu-20.04/22.04.

• Examples of WasmEdge Rust SDK
  • Wasm App
    • Example: Run a wasm app from host
  • Wasm Library
    • Example: Define a wasm library
    • Example: Use extern functions in a wasm library
    • Example: Dependencies between wasm libraries
  • Host Functions
    • Example: Define a host function
    • Example: Define a host function with host context data
    • Example: Define a host function with string arguments
    • Example: Arguments of non-standard wasm types in wasm function (wasmedge-bindgen)
  • Memory and Table
    • Example: Manipulate WebAssembly linear memory
    • Example: Use WebAssembly Table and FuncRef to invoke host functions
  • AOT
    • Example: Call wasm library in AOT mode
  • WASI
    • Example: Set environment variables and arguments via WasmEdge wasi interface
    • Example: Set environment variables, arguments and preopen-dirs via async-wasi interface
    • Example: Retrieve the socket address via async-wasi interface
  • WASI-NN
    • Example: AI inference over WasmEdge PyTorch Plugin
    • Example: Chat with Llama2
  • Plugin Development
    • Example: Create a simple plugin
    • Example: Run a plugin with Executor
  • Multi-threading
    • Example: Multi-threaded parallel execution with memory sharing
  • Async\await
    • Example: Define async host functions
    • Example: Define async host functions with host context data
    • Example: Call a wasm function in asynchromous way

Wasm App

Example: Run a wasm app from host

This example demonstrates how to create a WebAssembly application and run it as a wasm module over WasmEdge Runtime.

Wasm Library

Example: Define a wasm library

This example demonstrates how to define a wasm library and call the APIs exported from the wasm library in WasmEdge Runtime.

Example: Use extern functions in a wasm library

This example demonstrates how to use external functions in a wasm library, and how to call such a wasm library with WasmEdge Rust SDK.

Example: Dependencies between wasm libraries

This example demonstrates how a wasm function defined in one wasm library can be imported and called by another wasm library.

Host Functions

Example: Define a host function

This example demonstrates how to define a native function as a host function with #[host_function] macro, and register it into a WasmEdge Vm and run it over WasmEdge Runtime.

Example: Define a host function with host context data

This example demonstrates how to define a native function as a host function with #[host_function] macro. A host context data is used in the host function.

Example: Define a host function with string arguments

This example demonstrates how to define a host function that takes two arguments of Rust built-in String or string slice type.

Example: Arguments of non-standard wasm types in wasm function (wasmedge-bindgen)

This example demonstrates how to define wasm functions, of which the arguments are of Rust built-in types instead of WebAssembly types.

Memory and Table

Example: Manipulate WebAssembly linear memory

This example demonstrates how to manipulate linear memory.

Example: Use WebAssembly Table and FuncRef to invoke host functions

This example demonstrates how to use WebAssembly Table and FuncRef together to invoke host functions.

AOT

Example: Call wasm library in AOT mode

This example demonstrates how to generate a AOT file with WasmEdge AOT compiler, and then load the file and run the wasm function in AOT mode.

WASI

Example: Set environment variables and arguments via WasmEdge wasi interface

This example demonstrates how to set environment variables and arguments via WasmEdge wasi interface.

Example: Set environment variables, arguments and preopen-dirs via async-wasi interface

This example demonstrates how to call a wasm function in asynchronous way. Also, it presents the usage of async-wasi interface.

Example: Retrieve the socket address via async-wasi interface

This example presents how to retrieve the socket address information asynchronously.

WASI-NN

Example: AI inference over WasmEdge PyTorch Plugin

This example demonstrates how to perform an object detection task over WasmEdge Runtime.

Example: Chat with Llama2

This example demonstrates how to chat with Llama2 model driven by WasmEdge wasi-nn-ggml backend.

Plugin Development

Example: Create a simple plugin

This example demonstrates how to create a simple plugin with WasmEdge Rust SDK.

Example: Run a plugin with Executor

This example demonstrates how to create a simple plugin with WasmEdge Rust SDK, and run it with WasmEdge Executor.

Multi-threading

Example: Multi-threaded parallel execution with memory sharing

This example demonstrates how to use WasmEdge Rust SDK to create multiple threads to help us render Mandelbrot set in parallel, which is a compute-intensive workload. This example also present sharing the image memory between threads while rendering the image parallelly.

Async\await

Example: Define async host functions

This example demonstrates how to define a native async function as an async host function with #[async_host_function] macro, and register it into a WasmEdge Vm and run it over WasmEdge Runtime.

Example: Define async host functions with host context data

This example demonstrates how to define a native async function as an async host function with #[async_host_function] macro. A host context data is used in the host function.

Example: Call a wasm function in asynchromous way

This example demonstrates how to call a wasm function in asynchronous way.

wasmedge-rustsdk-examples's Issues

[QUESTION] How to pass `&[u8]` from Rust to Go?

For example, I've written some Go codes and compiled as WASM:

//export md5
func Md5(input []byte) string {
    // return md5 crypto...
}

// compile and got md5.wasm

In the rust wasmedge sdk:

// init vm and load md5.wasm above....

let mut b = Vec::from(&b"foobar"[..]);


let result = vm.run_func(
        Some("extern"),
        "md5",
        params // <------- How to pass `b` ???
    )?;

The `README` of `object-detection-via-wasinn` is outdated

Update the section about the installation of WasmEdge with PyTorch plugin.

Related issue report: WasmEdge/WasmEdge#2809

Example request: run external binary

I hope I can run https://github.com/antimatter15/alpaca.cpp 's binary from a wasm module, can I achieve this with wasmedge? So I can do C++ speeduped infer at the edge.

Is it able to export system function to wasm libs

I want to pass a function ptr to wasm lib

Cannot run examples

Hi there,

I am attempting to run a simple Rust SDK example, but getting the error:

error[E0425]: cannot find function, tuple struct or tuple variant WasmEdge_PluginLoadFromPath in module ffi
--> /home/neliusdelange/.cargo/registry/src/github.com-1ecc6299db9ec823/wasmedge-sys-0.13.0/src/plugin.rs:40:23
|
40 | unsafe { ffi::WasmEdge_PluginLoadFromPath(c_path.as_ptr()) }
| ^^^^^^^^^^^^^^^^^^^^^^^^^^^ not found in ffi

Please assist.

Thank you
Nelius

Can't access host function in wasm lib

first I registered the host function

let import = ImportObjectBuilder::new()
                .with_func::<(ExternRef, ExternRef), (), NeverType>("kv_set", kv_set, None)
                .unwrap()
                .build::<NeverType>("extern", None)
                .unwrap();
            (
                VmBuilder::new()
                    .with_config(config)
                    .build()
                    .expect("failed to create vm")
                    .register_import_module(import)
                    .unwrap()
                    .register_module(Some(container_name), module)
                    .unwrap(),

in wasm lib I try to access the kv_set function

#[allow(unused_imports)]
use wasmedge_bindgen::*;
use wasmedge_bindgen_macro::*;

extern "C" {
    fn kv_set(x: Vec<u8>) -> Vec<u8>;
}

pub fn kv_set_wrapper(x: Vec<u8>) -> Vec<u8> {
    unsafe { kv_set(x) }
}

#[wasmedge_bindgen]
pub fn fn2() {
    kv_set_wrapper(Vec::new());
    println!("helloworld");
}

However I get

Wasi-nn example in Async mode

Is there async mode example for wasi-nn? I am unable to add wasi-nn plugin to wasmedge_sdk async WasiCtx.

Example request: HTTP POST

Can I send http request using reqwest package? So I can use https://github.com/valentinegb/openai crate, which uses reqwest package.

I'm planning to switch from extism to wasmedge, because extism have poor support for HTTP request, and debug experience and test coverage are poor.