Light

bots-garden / capsule Goto Github PK

View Code? Open in Web Editor NEW

285.0 3.0 8.0 61.09 MB

A Capsule application is a runner (or launcher) of wasm functions. Capsule HTTP can serve the functions through HTTP (it’s possible to use Capsule as a simple CLI with Capsule CLI). And soon: NATS and MQTT

Home Page: https://bots-garden.github.io/capsule/

License: MIT License

Shell 7.13% Go 89.35% JavaScript 1.19% Dockerfile 0.34% HTML 1.99%

golang tinygo wasi wasm wazero webassembly

capsule's Introduction

Capsule, next generation

the nano wasm functions runners

What is the Capsule project?

Capsule is a set of WASM runners. Right now, the Capsule project is composed of:

Capsule CLI: to simply execute a WebAssembly module in a terminal
Capsule HTTP server to serve a WebAssembly module like a micro service or a function.

Capsule applications are developed with GoLang and thanks to the 💜 Wazero project.

The wasm modules are developed in GoLang and compiled with TinyGo 💜 (with the WASI specification)

Host DK & Module DK

The Capsule applications are developed thanks to the Capsule Host SDK (HDK)
The Capsule modules executed by the The Capsule applications are developed thanks to the Capsule Module SDK (MDK)

🎉 That means, since now, it's possible to develop various runners thanks to the Capsule HostSDK

capsule's People

Contributors

Stargazers

Watchers

Forkers

codefromthecrypt py4mac crt-fork titimoby darcyg dirien evacchi wasmlabx

capsule's Issues

add "CLI parameters" support

add NATS support 2️⃣: capsule is the client (we call functions through NATS query)

add environment variables support

refactoring 2nd part (helpers)

create a capsule module builder

add an http server mode to capsule

capsule module.wasm --http-serve

port is set with an environment variable

Then: specific "Handle" function for HTTP or CLI mode? 🤔

refactoring of the `hf` package (host functions) => split in several packages

add a dynamic "in memory" mode to the reverse proxy

better README 📝

change the project organization/structure + refactoring

keep the mono repo, but split the project into two projects:

capsule (the launcher)
capsule-module (the wasm module)

and refactoring of the various helpers

add https support

load the module by path+name as an argument of capsule

add a worker

REST API
Launcher of a wasm module in cli or http mode
Registration to the reverse-proxy
...

add CouchBase support

add more Redis commands

Delete, List, ...

add NATS support 1️⃣: the module is the client

add Redis support

a wasm module function can return a string

the wasm module should be able to know its http port

../capsule \
   -wasm=./hello.wasm \
   -mode=http \
   -httpPort=8080

workaround:

export HTTP_PORT=8080
../capsule \
   -wasm=./hello.wasm \
   -mode=http \
   -httpPort=$HTTP_PORT

protect environment variables

add Gitpod support to the project

add file read/write support

create the wasm runtime at every request (avoid out of bounds memory access)

create external samples of capsule modules

👀 see https://github.com/bots-garden/capsule-samples

add metrics route

fix docker build

improve the http execution mode (versus cli mode)

don't always return a json payload
give the ability to choose between text and json (set content type header)

add a message/trigger system between module and host

like with react?

add Devcontainer support to the project

add detailed comments in the examples

allow GET requests

fix memory issue

create action(s) to generate releases

add health check route

add a host function that takes a string parameter and returns a string

use case: the wasm module send a message

add echo (http server) support

to compare with gin gonic
https://echo.labstack.com/guide/

add PUT/DELETE methods support to the http host function

add error return to Handle function

find a json lib for TinyGo

use array of bytes as function parameter and return value

simplify the call of a function (only one entrypoint: `Handle`)

add json helpers to the wasm module

optimize with pool

explain how to add host functions

split project => capsule launcher + capsule module

or only extract samples?

load the wasm file from an URL

add a reverse-proxy mode

when the http port is already in use, Capsule exit without any error message

[host function] http request

simplify the call(s) from the host

simplify the source code

Recommend Projects

React

A declarative, efficient, and flexible JavaScript library for building user interfaces.
Vue.js

🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
Typescript

TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
TensorFlow

An Open Source Machine Learning Framework for Everyone
Django

The Web framework for perfectionists with deadlines.
Laravel

A PHP framework for web artisans
D3

Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

javascript

JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
web

Some thing interesting about web. New door for the world.
server

A server is a program made to process requests and deliver data to clients.
Machine learning

Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Visualization

Some thing interesting about visualization, use data art
Game

Some thing interesting about game, make everyone happy.

Recommend Org

Facebook

We are working to build community through open source technology. NB: members must have two-factor auth.
Microsoft

Open source projects and samples from Microsoft.
Google

Google ❤️ Open Source for everyone.
Alibaba

Alibaba Open Source for everyone
D3

Data-Driven Documents codes.
Tencent

China tencent open source team.