wasmer

<div align="center">
  <a href="https://wasmer.io">
    <picture>
      <source media="(prefers-color-scheme: dark)" srcset="./assets/logo-white.svg">
      <img width="300" src="./assets/logo.svg" alt="Wasmer">
    </picture>
  </a>

  <h3>Lightweight sandboxes for your apps and AI agents</h3>

  <p>
    <a href="#run-your-first-sandbox">Run with the CLI</a> ·
    <a href="#wasmer-sdk">Embed with the SDK</a> ·
    <a href="https://wasmer.sh">Try in your browser</a>
  </p>

  <p>
    <a href="https://github.com/wasmerio/wasmer/releases">
      <img src="https://img.shields.io/github/v/release/wasmerio/wasmer" alt="CLI release">
    </a>
    <a href="./LICENSE">
      <img src="https://img.shields.io/github/license/wasmerio/wasmer.svg" alt="MIT license">
    </a>
    <a href="https://github.com/wasmerio/wasmer-sdk">
      <img src="https://img.shields.io/badge/SDK-sandboxes-6f42c1" alt="Wasmer Sandbox SDK">
    </a>
    <a href="https://discord.gg/rWkMNStrEW">
      <img src="https://img.shields.io/discord/1110300506942881873?label=Discord&logo=discord&logoColor=white" alt="Wasmer on Discord">
    </a>
  </p>
</div>

Wasmer runs your apps in *fast*, *secure*, and *lightweight sandboxes*: locally,
in the cloud, or in your browser.

- **Secure** by default. You control file, network, and environment access.
- **Lightweight**. Fast startup with a small memory footprint.
- **Ready to run**. Python, JavaScript, Bash, and more from the [registry](https://wasmer.io/explore).
- **Embeddable**. Add sandboxes to your app with the [Wasmer SDK](#wasmer-sdk).

## Run your first sandbox

Install the CLI on macOS or Linux:

```sh
curl https://get.wasmer.io -sSfL | sh
```

<details>
<summary>Windows and other installation options</summary>

**Windows (PowerShell)**

```powershell
iwr https://win.wasmer.io -useb | iex
```

**Homebrew (macOS / Linux)**

```sh
brew install wasmer
```

See the [installation guide](https://docs.wasmer.io/install/) for more options.

</details>

Run Python in a sandbox:

```sh
wasmer run python/python -- -c "print('Hello from Wasmer')"
```

```text
Hello from Wasmer
```

Or try a shell command and Cowsay:

```sh
wasmer run wasmer/bash -- -c "echo 'Hello from Wasmer'"
wasmer run syrusakbary/cowsay -- "Hello from Wasmer"
```

Wasmer downloads the package and caches it for future runs. Use `--` to separate
Wasmer options from the arguments passed to your program. To work with local
files, grant access to a directory with `--volume`; enable host networking with
`--net` when your program needs it. See the
[CLI guide](https://docs.wasmer.io/runtime/cli/) for details.

**No installation needed:** open [wasmer.sh](https://wasmer.sh) to try a sandbox
in your browser.

## Wasmer SDK

Create a sandbox, choose your tools, and run code directly in your app with the
[Wasmer SDK](https://github.com/wasmerio/wasmer-sdk).

### Install the SDK

**JavaScript / TypeScript** (Node.js 20 or newer):

```sh
npm install @wasmer/sdk
```

<details>
<summary>Rust