{"id":13461373,"url":"https://github.com/tetratelabs/wazero","last_synced_at":"2025-05-12T03:40:03.598Z","repository":{"id":36956987,"uuid":"261141187","full_name":"tetratelabs/wazero","owner":"tetratelabs","description":"wazero: the zero dependency WebAssembly runtime for Go developers","archived":false,"fork":false,"pushed_at":"2025-04-14T14:32:04.000Z","size":22380,"stargazers_count":5340,"open_issues_count":18,"forks_count":280,"subscribers_count":42,"default_branch":"main","last_synced_at":"2025-05-01T13:51:02.191Z","etag":null,"topics":["ahead-of-time","compiler","go","golang","runtime","vm","wasi","wasm","webassembly"],"latest_commit_sha":null,"homepage":"https://wazero.io","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tetratelabs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2020-05-04T10:16:32.000Z","updated_at":"2025-05-01T12:25:57.000Z","dependencies_parsed_at":"2023-12-19T01:29:11.522Z","dependency_job_id":"29d6bf1a-121f-45dd-875e-e7aa8691127d","html_url":"https://github.com/tetratelabs/wazero","commit_stats":{"total_commits":1894,"total_committers":74,"mean_commits":"25.594594594594593","dds":0.6948257655755016,"last_synced_commit":"610c202ec48f3a7c729f2bf11707330127ab3689"},"previous_names":[],"tags_count":32,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tetratelabs%2Fwazero","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tetratelabs%2Fwazero/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tetratelabs%2Fwazero/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tetratelabs%2Fwazero/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tetratelabs","download_url":"https://codeload.github.com/tetratelabs/wazero/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253669566,"owners_count":21945113,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ahead-of-time","compiler","go","golang","runtime","vm","wasi","wasm","webassembly"],"created_at":"2024-07-31T11:00:36.490Z","updated_at":"2025-05-12T03:39:58.584Z","avatar_url":"https://github.com/tetratelabs.png","language":"Go","funding_links":[],"categories":["Members","Go","Go Runtimes","Web Assembly","webassembly","Repositories","Runtimes \u0026 Platforms","Programming Languages"],"sub_categories":["Golang"],"readme":"# wazero: the zero dependency WebAssembly runtime for Go developers\n\n[![Go Reference](https://pkg.go.dev/badge/github.com/tetratelabs/wazero.svg)](https://pkg.go.dev/github.com/tetratelabs/wazero) [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n\nWebAssembly is a way to safely run code compiled in other languages. Runtimes\nexecute WebAssembly Modules (Wasm), which are most often binaries with a `.wasm`\nextension.\n\nwazero is a WebAssembly Core Specification [1.0][1] and [2.0][2] compliant\nruntime written in Go. It has *zero dependencies*, and doesn't rely on CGO.\nThis means you can run applications in other languages and still keep cross\ncompilation.\n\nImport wazero and extend your Go application with code written in any language!\n\n## Example\n\nThe best way to learn wazero is by trying one of our [examples](examples/README.md). The\nmost [basic example](examples/basic) extends a Go application with an addition\nfunction defined in WebAssembly.\n\n## Runtime\n\nThere are two runtime configurations supported in wazero: _Compiler_ is default:\n\nBy default, ex `wazero.NewRuntime(ctx)`, the Compiler is used if supported. You\ncan also force the interpreter like so:\n```go\nr := wazero.NewRuntimeWithConfig(ctx, wazero.NewRuntimeConfigInterpreter())\n```\n\n### Interpreter\nInterpreter is a naive interpreter-based implementation of Wasm virtual\nmachine. Its implementation doesn't have any platform (GOARCH, GOOS) specific\ncode, therefore _interpreter_ can be used for any compilation target available\nfor Go (such as `riscv64`).\n\n### Compiler\nCompiler compiles WebAssembly modules into machine code ahead of time (AOT),\nduring `Runtime.CompileModule`. This means your WebAssembly functions execute\nnatively at runtime. Compiler is faster than Interpreter, often by order of\nmagnitude (10x) or more. This is done without host-specific dependencies.\n\n### Conformance\n\nBoth runtimes pass WebAssembly Core [1.0][7] and [2.0][14] specification tests\non supported platforms:\n\n|   Runtime   |                 Usage                  | amd64 | arm64 | others |\n|:-----------:|:--------------------------------------:|:-----:|:-----:|:------:|\n| Interpreter | `wazero.NewRuntimeConfigInterpreter()` |   ✅   |   ✅   |   ✅    |\n|  Compiler   |  `wazero.NewRuntimeConfigCompiler()`   |   ✅   |   ✅   |   ❌    |\n\n## Support Policy\n\nThe below support policy focuses on compatibility concerns of those embedding\nwazero into their Go applications.\n\n### wazero\n\nwazero's [1.0 release][15] happened in March 2023, and is [in use][16] by many\nprojects and production sites.\n\nWe offer an API stability promise with semantic versioning. In other words, we\npromise to not break any exported function signature without incrementing the\nmajor version. This does not mean no innovation: New features and behaviors\nhappen with a minor version increment, e.g. 1.0.11 to 1.2.0. We also fix bugs\nor change internal details with a patch version, e.g. 1.0.0 to 1.0.1.\n\nYou can get the latest version of wazero like this.\n```bash\ngo get github.com/tetratelabs/wazero@latest\n```\n\nPlease give us a [star][17] if you end up using wazero!\n\n### Go\n\nwazero has no dependencies except Go, so the only source of conflict in your\nproject's use of wazero is the Go version.\n\nwazero follows the same version policy as Go's [Release Policy][10]: two\nversions. wazero will ensure these versions work and bugs are valid if there's\nan issue with a current Go version.\n\nAdditionally, wazero intentionally delays usage of language or standard library\nfeatures one additional version. For example, when Go 1.29 is released, wazero\ncan use language features or standard libraries added in 1.27. This is a\nconvenience for embedders who have a slower version policy than Go. However,\nonly supported Go versions may be used to raise support issues.\n\n### Platform\n\nwazero has two runtime modes: Interpreter and Compiler. The only supported operating\nsystems are ones we test, but that doesn't necessarily mean other operating\nsystem versions won't work.\n\nWe currently test Linux (Ubuntu and scratch), MacOS and Windows as packaged by\n[GitHub Actions][11], as well as nested VMs running on Linux for FreeBSD, NetBSD,\nOpenBSD, DragonFly BSD, illumos and Solaris.\n\nWe also test cross compilation for many `GOOS` and `GOARCH` combinations.\n\n* Interpreter\n  * Linux is tested on amd64 (native) as well arm64 and riscv64 via emulation.\n  * Windows, FreeBSD, NetBSD, OpenBSD, DragonFly BSD, illumos and Solaris are\n    tested only on amd64.\n  * macOS is tested only on arm64.\n* Compiler\n  * Linux is tested on amd64 (native) as well arm64 via emulation.\n  * Windows, FreeBSD, NetBSD, DragonFly BSD, illumos and Solaris are\n    tested only on amd64.\n  * macOS is tested only on arm64.\n\nwazero has no dependencies and doesn't require CGO. This means it can also be\nembedded in an application that doesn't use an operating system. This is a main\ndifferentiator between wazero and alternatives.\n\nWe verify zero dependencies by running tests in Docker's [scratch image][12].\nThis approach ensures compatibility with any parent image.\n\n-----\nwazero is a registered trademark of Tetrate.io, Inc. in the United States and/or other countries\n\n[1]: https://www.w3.org/TR/2019/REC-wasm-core-1-20191205/\n[2]: https://www.w3.org/TR/2022/WD-wasm-core-2-20220419/\n[4]: https://github.com/WebAssembly/meetings/blob/main/process/subgroups.md\n[5]: https://github.com/WebAssembly/WASI\n[6]: https://pkg.go.dev/golang.org/x/sys/unix\n[7]: https://github.com/WebAssembly/spec/tree/wg-1.0/test/core\n[9]: https://github.com/tetratelabs/wazero/issues/506\n[10]: https://go.dev/doc/devel/release\n[11]: https://github.com/actions/virtual-environments\n[12]: https://docs.docker.com/develop/develop-images/baseimages/#create-a-simple-parent-image-using-scratch\n[13]: https://github.com/WebAssembly/WASI/blob/snapshot-01/phases/snapshot/docs.md\n[14]: https://github.com/WebAssembly/spec/tree/d39195773112a22b245ffbe864bab6d1182ccb06/test/core\n[15]: https://tetrate.io/blog/introducing-wazero-from-tetrate/\n[16]: https://wazero.io/community/users/\n[17]: https://github.com/tetratelabs/wazero/stargazers\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftetratelabs%2Fwazero","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftetratelabs%2Fwazero","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftetratelabs%2Fwazero/lists"}