Debian Codegraph @

site/content/_index.md

raw
1 +++
2 title = "the _zero_ dependency _WebAssembly_ runtime for _Go developers_"
3 layout = "home"
4 +++
5
6
7 **WebAssembly** is a way to safely run code compiled in other languages. Runtimes
8 execute WebAssembly Modules (Wasm), which are most often binaries with a
9 `.wasm` extension.
10
11 **wazero** is the only zero dependency WebAssembly runtime written in Go.
12
13 ## Get Started
14
15 **Get the wazero CLI** and run any Wasm binary
16
17 ```bash
18 curl https://wazero.io/install.sh | sh
19 ./bin/wazero run app.wasm
20 ```
21
22 **Embed wazero** in your Go project and extend any app
23
24 ```go
25 import "github.com/tetratelabs/wazero"
26
27 // ...
28
29 r := wazero.NewRuntime(ctx)
30 defer r.Close(ctx)
31 mod, _ := r.Instantiate(ctx, wasmAdd)
32 res, _ := mod.ExportedFunction("add").Call(ctx, 1, 2)
33 ```
34
35 -----
36
37 ## Example
38
39 The best way to learn wazero is by trying one of our [examples][1]. The
40 most [basic example][2] extends a Go application with an addition function
41 defined in WebAssembly.
42
43 ## Why zero?
44
45 By avoiding CGO, wazero avoids prerequisites such as shared libraries or libc,
46 and lets you keep features like cross compilation. Being pure Go, wazero adds
47 only a small amount of size to your binary. Meanwhile, wazero’s API gives
48 features you expect in Go, such as safe concurrency and context propagation.
49
50 ### When can I use this?
51
52 You can use wazero today! wazero's [1.0 release][3] happened in March 2023, and
53 is [in use]({{< relref "/community/users.md" >}}) by many projects and
54 production sites.
55
56 You can get the latest version of wazero like this.
57 ```bash
58 go get github.com/tetratelabs/wazero@latest
59 ```
60
61 Please give us a [star][4] if you end up using wazero!
62
63 [1]: https://github.com/tetratelabs/wazero/blob/main/examples
64 [2]: https://github.com/tetratelabs/wazero/blob/main/examples/basic
65 [3]: https://tetrate.io/blog/introducing-wazero-from-tetrate/
66 [4]: https://github.com/tetratelabs/wazero/stargazers