$git clone https://github.com/microsoft/wassette[Quick Start] | [FAQ] | [Documentation] | [Releases] | [Contributing] | [Discord] </div>
| 1 | <div align="center"> |
| 2 | <h1 align="center">Wassette</h1> |
| 3 | <p><b>A security-oriented runtime that runs WebAssembly Components via MCP</b></p> |
| 4 | |
| 5 | <!-- <a href="https://discord.gg/microsoft-open-source"> |
| 6 | <img src="https://dcbadge.limes.pink/api/server/microsoft-open-source" alt="Discord" style="height: 25px;"> |
| 7 | </a> --> |
| 8 | |
| 9 | [Quick Start] | [FAQ] | [Documentation] | [Releases] | [Contributing] | [Discord] |
| 10 | </div> |
| 11 | |
| 12 | > [!WARNING] |
| 13 | > **Early Development**: This repository is not production ready yet. It is in early development and may change significantly. |
| 14 | |
| 15 | ## Why Wassette? |
| 16 | |
| 17 | - **Convenience**: Wassette makes it easy to extend AI agents with new tools, |
| 18 | all without ever having to leave the chat window. |
| 19 | - **Reusability**: Wasm Components are generic and reusable; |
| 20 | there is nothing MCP-specific about them. |
| 21 | - **Security**: Wassette is built on the Wasmtime security sandbox, providing |
| 22 | browser-grade isolation of tools. |
| 23 | |
| 24 | ## Architecture |
| 25 | |
| 26 |  |
| 27 | |
| 28 | ## Installation |
| 29 | |
| 30 | **Quick start:** For Linux/macOS, use our one-liner install script: |
| 31 | |
| 32 | ```bash |
| 33 | curl -fsSL https://raw.githubusercontent.com/microsoft/wassette/main/install.sh | bash |
| 34 | ``` |
| 35 | |
| 36 | **For complete installation instructions** for all platforms (including Windows, Homebrew, Nix, Docker, and more), see our **[Installation Guide](https://microsoft.github.io/wassette/latest/installation.html)**. |
| 37 | |
| 38 | ## Using Wassette |
| 39 | |
| 40 | With Wassette installed, the next step is to register it with your agent of choice. See our [Quick Start] guide (3 simple steps), or check the [MCP Clients guide](https://microsoft.github.io/wassette/latest/mcp-clients.html) for detailed setup instructions for GitHub Copilot, Cursor, Claude Code, and Gemini CLI. |
| 41 | |
| 42 | Once configured, you can start loading WebAssembly components. To teach your agent to tell the time, ask it to load a time component: |
| 43 | |
| 44 | ```text |
| 45 | Please load the time component from oci://ghcr.io/microsoft/time-server-js:latest |
| 46 | ``` |
| 47 | |
| 48 | Now that the time component is loaded, we can ask your agent to tell you the current time: |
| 49 | |
| 50 | ```text |
| 51 | What is the current time? |
| 52 | ``` |
| 53 | |
| 54 | The agent will respond with the current time, which is fetched from the time component running in a secure WebAssembly sandbox: |
| 55 | |
| 56 | ```output |
| 57 | The current time July 31, 2025 at 10:30 AM UTC |
| 58 | ``` |
| 59 | |
| 60 | Congratulations! You've just run your first Wasm Component and taught your agent how to tell time! |
| 61 | |
| 62 | ## Demo |
| 63 | |
| 64 | https://github.com/user-attachments/assets/8e5a371c-ac72-406d-859c-03833ee83963 |
| 65 | |
| 66 | ## Discord |
| 67 | |
| 68 | You can join us via the `#wassette` channel on the [Microsoft Open Source Discord](https://discord.gg/microsoft-open-source): |
| 69 | |
| 70 | [](https://discord.gg/microsoft-open-source) |
| 71 | |
| 72 | ## Contributing |
| 73 | |
| 74 | Please see [CONTRIBUTING.md][Contributing] for more information on how to contribute to this project. |
| 75 | |
| 76 | ## License |
| 77 | |
| 78 | This project is licensed under the <a href="LICENSE">MIT License</a>. |
| 79 | |
| 80 | ## Trademarks |
| 81 | |
| 82 | 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](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks). 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. |
| 83 | |
| 84 | [Quick Start]: https://microsoft.github.io/wassette/latest/quick-start.html |
| 85 | [FAQ]: https://microsoft.github.io/wassette/latest/faq.html |
| 86 | [Documentation]: https://microsoft.github.io/wassette |
| 87 | [Contributing]: CONTRIBUTING.md |
| 88 | [Releases]: https://github.com/microsoft/wassette/releases |
| 89 | [Discord]: https://discord.gg/microsoft-open-source |
| 90 | |
| 91 | ## Contributors |
| 92 | |
| 93 | Thanks to all contributors who are helping shape Wassette into something great. |
| 94 | |
| 95 | <a href="https://github.com/ |