Skip to content

Repository files navigation

Cosmonic

Awesome Cosmonic

Community-maintained components, host plugins, workload examples, and tools for Cosmonic Control.

License Docs Slack


Cosmonic Control is a Kubernetes-native control plane for running microservices, agentic workflows, MCP servers, and other sensitive or untrusted code inside WebAssembly component sandboxes. Workloads are built with wash and wired to capabilities at runtime rather than at build time. This repository collects what the community has built on top of it.

Source may be hosted here or linked. A project can live in this repository as a directory with its own README, license, and build instructions, or stay in its own repository and be listed here with a link. Entries are tagged (hosted) or (linked) so you know which you are getting. See CONTRIBUTING.md to add yours.

For a project hosted here, clone and build it directly:

git clone https://github.com/cosmonic-labs/awesome-cosmonic.git
cd awesome-cosmonic/workload-examples/<project>
wash build

Contents

Components

Reusable WebAssembly components that implement a WIT interface. Hosted projects live in components/.

Nothing here yet. Add the first one.

MCP Servers

Model Context Protocol servers built as WebAssembly components, so the tools an agent calls run inside a sandbox rather than with ambient host access. Hosted projects live in components/mcp-servers/.

  • mcp-server-template-ts (linked): Template for building an MCP server as a TypeScript component served over wasi:http, scaffolded with wash new. The dev loop launches the official MCP inspector, and an openapi2mcp script generates tools from an OpenAPI specification.

Host Plugins

Cosmonic Control schedules workloads onto wasmCloud hosts. Host plugins extend a host with an implementation of a WIT world, which is linked to workloads at runtime. They come in two flavors, and a workload cannot tell which one is serving a capability it imports.

Native Host Plugins

Rust implementations of the HostPlugin trait, linked into the host binary. The right choice when a capability needs direct host resources (filesystem, network, hardware) or has to run with the host's privileges. Hosted projects live in host-plugins/native/.

Nothing here yet. Add the first one.

Component Host Plugins

Capabilities built as WebAssembly components and deployed into a host at runtime as trigger services with a capability ingress, so you ship, version, and sandbox them like any other component. Currently opt-in via the host-component-plugins feature, so check the docs for the state of play before depending on one. Hosted projects live in host-plugins/component/.

Nothing here yet. Add the first one.

Workload Examples

End-to-end applications demonstrating how components compose into a running system. Hosted projects live in workload-examples/.

For starting points maintained by Cosmonic rather than the community, see the Template Catalog.

  • control-demos (linked): Reference components and demos for Cosmonic Control on Kubernetes, spanning Rust, Go, and TypeScript: a NATS-backed blobstore fileserver, HTTP servers, a Hono and Swagger UI API explorer, and an Argo CD GitOps integration. Ships Helm charts and a kind config for running the whole set locally.

Tools

CLIs, libraries, editor integrations, and developer tooling. Hosted projects live in tools/.

Nothing here yet. Add the first one.

Contributing

Contributions are welcome. Read CONTRIBUTING.md first for the two contribution routes, licensing rules, and what a project needs to be accepted.

Projects here are contributed by the community and maintained by their authors. Inclusion is not an endorsement, security review, or statement of production readiness. Read the code before running it.

Community

License

The repository is Apache-2.0. Projects hosted here carry their own LICENSE file in their directory, which governs that project.

About

Examples, inspiration, and templates for your ideas. This repository also includes source code for the Examples section on https://cosmonic.com/docs/category/examples

Topics

Resources

Contributing

Stars

32 stars

Watchers

3 watching

Forks

Packages

Used by

Contributors

Languages