2 unstable releases

0.1.0 Nov 9, 2023
0.0.1 Mar 27, 2021

#154 in WebAssembly

Download history 2/week @ 2023-10-29 76/week @ 2023-11-05 222/week @ 2023-11-12 255/week @ 2023-11-19 154/week @ 2023-11-26 105/week @ 2023-12-03 201/week @ 2023-12-10 121/week @ 2023-12-17 88/week @ 2023-12-24 105/week @ 2023-12-31 176/week @ 2024-01-07 158/week @ 2024-01-14 111/week @ 2024-01-21 118/week @ 2024-01-28 73/week @ 2024-02-04

469 downloads per month
Used in 2 crates (via wasmcloud-provider-sdk)

Apache-2.0

40KB
778 lines

Homepage and Documentation CNCF sandbox project Stars Powered by WebAssembly
OpenSSF Best Practices OpenSSF Scorecard Artifact Hub CLOMonitor FOSSA Status twitter youtube subscribers youtube views

wasmCloud logo

πŸ’» Distributed computing, simplified

The wasmCloud runtime is a vessel for running applications in the cloud, at the edge, in the browser, on small devices, and anywhere else you can imagine.

Move from concept to production without changing your design, architecture, or your programming environment.

wasmCloud lets you focus on shipping features. Build secure, portable, re-usable components. Get rid of the headaches from being smothered by boilerplate, dependency hell, tight coupling, and designs mandated by your infrastructure.

Core Tenets

  • Dead simple distributed applications
  • Run anywhere
  • Secure by default
  • Productivity for both developers and operations

Getting Started

Installation

Install the wasmCloud Shell (wash) with one command.

Walkthrough

If you're new to the wasmCloud ecosystem, a great place to start is the getting started walkthrough.

Quickstart

The following commands launch wasmCloud in a local development environment and deploy a simple "hello world" WebAssembly module.

wash up -d
wash new actor -t hello hello
wash app deploy ./hello/wadm.yaml
curl localhost:8080

Examples

WebAssembly Modules (Stable ABI)

wasmCloud has a wide range of examples built on the stable ABI. This includes actors, providers, interfaces, and full applications we've created to demonstrate how to design, compose, and build applications in wasmCloud.

Experimental WASI Preview 2 WebAssembly Components

wasmCloud is actively staying up-to-date with WASI Preview 2 and the Component Model. For actor components which consume interfaces defined in WIT, see examples in the examples directory of this repository.

πŸ’₯ Awesome wasmCloud

For even more examples, check out awesome projects using wasmCloud from our community members!

πŸ—ΊοΈ Roadmap and Vision

We have plenty of ideas and things going on in the wasmCloud project. Please check out the Roadmap doc for more information, and the wasmCloud Roadmap project to see the status of new features.

Releases

The latest release and changelog can be found on the releases page.

πŸ§‘β€πŸ’» Contributing

Want to get involved? For more information on how to contribute and our contributor guidelines, check out the contributing readme.


πŸŒ‡ Community Resources

Community Meetings

We host weekly community meetings at 1pm EST on Wednesdays. These community meetings are livestreamed to our Twitter account and to YouTube. You can find the agenda and notes for each meeting in the community secton of our webste. If you're interested in joining in on the call to demo or take part in the discussion, we have a Zoom link on our community calendar.

Slack

We host our own community slack for all community members to join and talk about WebAssembly, wasmCloud, or just general cloud native technology. For those of you who are already on the CNCF Slack, we also have our own channel at #wasmcloud.


πŸ“š Reference Documentation

wasmCloud uses some terminology you might not be familiar with. Check out the concepts section of our docs for a deeper dive.


RPC Framework

wasmCloud uses an RPC API to enable seamless communication among the host runtime, actors, and providers.


Declarative Deployments

The wasmCloud Application Deployment Manager wadm uses the Open Application Model to define and deploy application specifications.


Host Runtimes

πŸ¦€ Rust Runtime

wasmCloud's standard runtime is built in Rust for its zero-cost abstractions, safety, security, and WebAssembly support.

πŸ•Έ JavaScript Runtime (Experimental)

For running a wasmCloud host in a browser or embedding in a JavaScript V8 host, use the JavaScript Runtime

☁️ Elixir/OTP Runtime (Deprecated)

Note: The OTP Runtime is now deprecated.

The Elixir/OTP runtime leverages Elixir/OTP for its battle-tested, massively-scalable foundation. It also leverages a Rust library.


SDKs and libraries

Rust Provider SDK

wasmCloud provides an SDK for building capability providers in Rust.

Go Provider SDK (Experimental)

wasmCloud also has an experimental SDK for building capability providers in Go.

Provider Bindgen from WIT Interfaces (Experimental)

wasmcloud-provider-wit-bindgen is a Rust macro used to generate code for capability providers.

Provider Archive

provider-archive is a crate used to create Provider Archive (PAR) files. PARs are used to store, retrieve, and sign capability providers. Today, capability providers are distributed as binary files and run as system processes. In the future, wasmCloud aims to build capability providers as WebAssembly Components, which will remove the need for Provider Archives.

wasmcloud_actor (Experimental)

wasmcloud_actor is a wasmCloud actor library written in Rust which facilitates building of wasmCloud actors.

The API of the crate matches closely what wit-bindgen would generate, meaning that one can switch from using plain wit-bindgen-generated bindings to wasmcloud_actor (and back) with minimal or no code changes.

wascap

wascap is a low-level library used to insert and retrieve claims on actors and providers. Claims are part of wasmCloud's zero-trust security model.


We are a Cloud Native Computing Foundation sandbox project.

Dependencies

~25–41MB
~748K SLoC