Installation
Wassette is available for Linux, macOS, and Windows. Choose the installation method that best suits your platform and workflow.
Quick Start
For the fastest installation experience, we recommend:
- Linux/macOS: Use our one-liner install script
- macOS: Use Homebrew
- Windows: Use WinGet
- Nix users: Use Nix flakes
Installation by Platform
Quick Install Script (Recommended)
The easiest way to install Wassette on Linux is using our automated install script:
curl -fsSL https://raw.githubusercontent.com/microsoft/wassette/main/install.sh | bash
This script will:
- Automatically detect your system architecture (x86_64 or ARM64)
- Download the latest Wassette release
- Install the binary to
~/.local/bin
- Configure your shell PATH for immediate access
Homebrew
If you prefer using Homebrew on Linux:
brew tap microsoft/wassette https://github.com/microsoft/wassette
brew install wassette
Manual Download
You can also download the latest Linux release manually from the GitHub Releases page and add it to your $PATH
.
Verifying the Installation
After installation, verify that Wassette is properly installed and accessible:
wassette --version
This should display the installed version of Wassette.
Supported Platforms
Wassette supports the following platforms:
Operating System | Architecture | Support |
---|---|---|
Linux | x86_64 (amd64) | ✅ Full support |
Linux | ARM64 (aarch64) | ✅ Full support |
macOS | Intel (x86_64) | ✅ Full support |
macOS | Apple Silicon (ARM64) | ✅ Full support |
Windows | x86_64 | ✅ Full support |
Windows | ARM64 | ✅ Full support |
Windows Subsystem for Linux | x86_64, ARM64 | ✅ Full support |
Next Steps
Once Wassette is installed, you’ll need to configure it with your AI agent:
-
Configure with your AI agent: Follow the MCP clients setup guide for instructions on integrating Wassette with:
- Visual Studio Code
- Cursor
- Claude Code
- Gemini CLI
-
Load your first component: Try loading a sample component to verify everything works:
Please load the time component from oci://ghcr.io/yoshuawuyts/time:latest
-
Explore examples: Check out the examples directory for sample components in different languages.
Troubleshooting
Command not found
If you get a “command not found” error after installation:
-
Linux/macOS: Ensure
~/.local/bin
is in your PATH. You may need to restart your terminal or run:export PATH="$HOME/.local/bin:$PATH"
-
Windows: Ensure the installation directory is in your system PATH. You may need to restart your terminal or log out and back in.
Permission denied
If you encounter permission errors:
-
Linux/macOS: Ensure the binary has execute permissions:
chmod +x ~/.local/bin/wassette
-
Windows: Run PowerShell as Administrator when installing with WinGet.
Other Issues
For additional help:
- Check the FAQ for common questions and answers
- Visit our GitHub Issues page
- Join our community discussions
Upgrading
To upgrade to the latest version of Wassette:
- Homebrew:
brew update && brew upgrade wassette
- WinGet:
winget upgrade Wassette
- Install script: Re-run the install script
- Nix:
nix profile upgrade github:microsoft/wassette
- Manual: Download the latest release and replace your existing binary