Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/Mewz-project/Mewz

A unikernel designed specifically for running Wasm applications and compatible with WASI
https://github.com/Mewz-project/Mewz

kernel unikernel wasm webassembly webassembly-runtime zig

Last synced: 24 days ago
JSON representation

A unikernel designed specifically for running Wasm applications and compatible with WASI

Host: GitHub
URL: https://github.com/Mewz-project/Mewz
Owner: mewz-project
License: gpl-3.0
Created: 2023-12-28T05:40:06.000Z (6 months ago)
Default Branch: main
Last Pushed: 2024-04-27T02:45:32.000Z (2 months ago)
Last Synced: 2024-04-27T03:27:10.886Z (2 months ago)
Topics: kernel, unikernel, wasm, webassembly, webassembly-runtime, zig
Language: Zig
Homepage:
Size: 1.19 MB
Stars: 417
Watchers: 5
Forks: 13
Open Issues: 9
Metadata Files:
- Readme: README.md
- License: LICENSE

Lists

awesome-stars - Mewz-project/Mewz - A unikernel designed specifically for running Wasm applications and compatible with WASI (Zig)

README

# Mewz

![](img/mewz-logo.png)

Mewz is a unikernel designed specifically for running Wasm applications and compatible with WASI.

## What's new with Mewz

There are now various Wasm runtimes, but they operate on general-purpose operating systems such as Linux or Windows.

Mewz is **a specialized kernel designed for running Wasm**. Mewz runs a single Wasm application within the kernel by linking it together during the build process with the Wasm application. (A kernel composed in this manner is commonly referred to as a **unikernel**.) In this way, Mewz provides **the minimal required features and environment for executing Wasm**.

![](img/mewz-architecture.png)

## Quick Start

There are some example programs. Please check out [examples](https://github.com/Mewz-project/Mewz/tree/main/examples).

### Option1: Docker

We prepare for a Docker image that has a environment for running Mewz.

```sh
curl -o helloworld.wat https://raw.githubusercontent.com/Mewz-project/Wasker/main/helloworld.wat
docker run -v .:/volume ghcr.io/mewz-project/mewz helloworld.wat
```

This image internally run [Wasker](https://github.com/mewz-project/wasker), build Mewz, and run it on QEMU.

![](img/mewz-demo.gif)

### Option2: Dev Container

You can use Dev Container on GitHub Codespaces or your local VSCode.

To start Codespaces,

- Click Code -> Codespaces -> New codespace on this repository page.
- Wait for a while, then you can see VSCode on browser.
- Open terminal on VSCode

```sh
# On the Dev Container
git submodule update --init
curl -o helloworld.wat https://raw.githubusercontent.com/Mewz-project/Wasker/main/helloworld.wat
wasker helloworld.wat
zig build -Dapp-obj=wasm.o run
```

### Option3: Build from source

Compile a Wasm file into a native object file, using [Wasker](https://github.com/mewz-project/wasker). Follow the instruction [here](https://github.com/mewz-project/wasker#how-to-run-wasker).

Then, build Mewz and run it on QEMU with the following commands.

```sh
zig build -Dapp-obj= run
```

To use file systems, specify the directory by `-Ddir=`. See [examples/static_file_server](examples/static_file_server/).

> [!WARNING]
> This option makes an archive of the directory by `tar` and attach it to QEMU.

> [!NOTE]
> QEMU's port 1234 is mapped to localhost:1234.

### Current Status