2020-02-20 14:48:10 -08:00
2019-02-19 17:01:44 -07:00
< p align = "center" >
< a href = "https://wasmer.io" target = "_blank" rel = "noopener noreferrer" >
2020-02-20 14:48:10 -08:00
< img width = "300" src = "https://raw.githubusercontent.com/wasmerio/wasmer/master/assets/logo.png" alt = "Wasmer logo" >
2019-02-19 17:01:44 -07:00
< / a >
< / p >
2020-02-20 14:49:55 -08:00
2020-02-20 14:48:10 -08:00
[Website ](https://wasmer.io ) • [Docs ](https://docs.wasmer.io/ ) • [Examples ](https://github.com/wasmerio/wasmer/tree/master/examples ) • [Blog ](https://medium.com/wasmer ) • [Slack ](https://slack.wasmer.io/ ) • [Twitter ](https://twitter.com/wasmerio )
2020-02-20 14:50:33 -08:00
< p >
2019-08-31 21:13:46 -07:00
< a href = "https://dev.azure.com/wasmerio/wasmer/_build/latest?definitionId=3&branchName=master" >
< img src = "https://img.shields.io/azure-devops/build/wasmerio/wasmer/3.svg?style=flat-square" alt = "Build Status" >
2019-02-19 17:01:44 -07:00
< / a >
< a href = "https://github.com/wasmerio/wasmer/blob/master/LICENSE" >
2019-08-31 21:13:46 -07:00
< img src = "https://img.shields.io/github/license/wasmerio/wasmer.svg?style=flat-square" alt = "License" >
2019-02-19 17:01:44 -07:00
< / a >
2019-01-28 10:12:23 -08:00
< a href = "https://spectrum.chat/wasmer" >
2019-02-19 17:01:44 -07:00
< img src = "https://withspectrum.github.io/badge/badge.svg" alt = "Join the Wasmer Community" >
2019-01-28 10:12:23 -08:00
< / a >
2018-11-05 14:52:53 +01:00
< / p >
2018-10-11 21:29:36 +02:00
2020-02-20 14:48:10 -08:00
[Wasmer ](https://wasmer.io/ ) is a standalone WebAssembly runtime for running WebAssembly [outside of the browser ](https://webassembly.org/docs/non-web/ ):
* *Universal*: Wasmer is available in **Linux, macOS and Windows** (for both x86 and [ARM ](https://medium.com/wasmer/running-webassembly-on-arm-7d365ed0e50c ))
* *Pluggable*: Wasmer can be used from almost **any programming language**
* *Safe*: supporting [WASI ](https://github.com/WebAssembly/WASI ) and [Emscripten ](https://emscripten.org/ )
2020-01-15 15:50:09 +01:00
2020-02-20 14:48:10 -08:00
It is used to run software fast, universally and safely: standalone applications and universal libraries.
2020-01-15 15:50:09 +01:00
2020-02-20 14:48:10 -08:00
## Contents
2019-07-31 18:09:23 -07:00
2020-02-20 14:48:10 -08:00
- [Quickstart ](#quickstart )
- [Language Integrations ](#examples )
- [Contribute ](#contribute )
- [Community ](#community )
2019-09-01 01:56:23 -07:00
2020-02-20 14:48:10 -08:00
## Quickstart
2019-09-01 01:56:23 -07:00
2020-02-20 14:48:10 -08:00
Get started with Wasmer:
2019-01-24 14:50:29 -08:00
2020-02-20 14:48:10 -08:00
#### 1. Install Wasmer
2018-10-14 23:49:10 +02:00
```sh
2020-02-20 14:48:10 -08:00
curl https://get.wasmer.io -sSfL | sh
2019-01-22 21:22:23 -08:00
```
2020-02-20 14:48:10 -08:00
> Note: *Wasmer is also [available on Windows](https://github.com/wasmerio/wasmer/releases)*
2019-07-24 17:42:03 -07:00
< details >
2020-02-20 14:48:10 -08:00
< summary > < b > Alternative< / b > : Install with Homebrew< / summary >
2019-07-24 17:42:03 -07:00
< p >
2019-01-22 21:22:23 -08:00
2020-02-20 14:48:10 -08:00
If you have [Homebrew ](https://brew.sh/ ) installed in your system:
2019-04-01 09:48:32 +02:00
```sh
2020-02-20 14:48:10 -08:00
brew install wasmer
2019-04-01 09:48:32 +02:00
```
2019-09-30 19:47:10 -07:00
2020-02-20 14:48:10 -08:00
< / p >
2019-07-24 17:42:03 -07:00
< / details >
2020-02-20 14:48:10 -08:00
#### 2. Use Wasmer
2019-01-22 21:22:23 -08:00
2020-02-20 14:48:10 -08:00
Download a WASM file, and use it universally! You can start with QuickJS: [qjs.wasm ](https://registry-cdn.wapm.io/contents/_/quickjs/0.0.3/build/qjs.wasm )
2019-09-30 19:47:10 -07:00
2020-02-20 14:48:10 -08:00
```bash
wasmer qjs.wasm
2019-07-05 18:57:30 -07:00
```
2020-02-20 14:48:10 -08:00
#### 3. Next steps
2019-08-22 11:26:23 -07:00
2020-02-20 14:48:10 -08:00
Here is what you can do next:
2019-09-30 19:47:10 -07:00
2020-02-20 14:48:10 -08:00
- [Use Wasmer from your Rust application ](https://docs.wasmer.io/integrations/rust )
- [Publish a Wasm package on WAPM ](https://docs.wasmer.io/ecosystem/wapm/publishing-your-package )
- [Read more about Wasmer ](https://medium.com/wasmer/ )
2018-10-11 21:29:36 +02:00
2019-07-31 21:11:29 -07:00
2020-02-20 14:48:10 -08:00
### Language Integrations
2018-10-14 23:49:10 +02:00
2020-02-20 14:48:10 -08:00
Wasmer runtime can be used as a library embedded in different languages, so you can **use WebAssembly anywhere** 🎉
2018-10-24 12:07:52 +02:00
2020-02-20 14:48:10 -08:00
| | Language | Docs | Author(s) | Maintenance | Release | Stars |
|-|-|-|-|-|-|-|
|  | [**Rust** ](https://github.com/wasmerio/wasmer-rust-example ) | [Docs ](https://wasmerio.github.io/wasmer/crates/wasmer_runtime/ ) | Wasmer | actively developed | < a href = "https://crates.io/crates/wasmer-runtime/" target = "_blank" > </ a > |  |
|  | [**C/C++** ](https://github.com/wasmerio/wasmer-c-api ) | [Docs ](https://wasmerio.github.io/wasmer/c/runtime-c-api/ ) | Wasmer | actively developed | < a href = "https://github.com/wasmerio/wasmer-c-api/" target = "_blank" > </ a > |  |
|  | [**Python** ](https://github.com/wasmerio/python-ext-wasm ) | [Docs ](https://github.com/wasmerio/python-ext-wasm#api-of-the-wasmer-extensionmodule ) | Wasmer | actively developed | < a href = "https://pypi.org/project/wasmer/" target = "_blank" > </ a > |  |
|  | [**Go** ](https://github.com/wasmerio/go-ext-wasm ) | [Docs ](https://github.com/wasmerio/go-ext-wasm#basic-example-exported-function ) | Wasmer | actively developed | < a href = "https://github.com/wasmerio/go-ext-wasm" target = "_blank" > </ a > |  |
|  | [**PHP** ](https://github.com/wasmerio/php-ext-wasm ) | [Docs ](https://wasmerio.github.io/php-ext-wasm/wasm/ ) | Wasmer | actively developed | < a href = "https://pecl.php.net/package/wasm" target = "_blank" > </ a > |  |
|  | [**Ruby** ](https://github.com/wasmerio/ruby-ext-wasm ) | [Docs ](https://www.rubydoc.info/gems/wasmer/ ) | Wasmer | actively developed | < a href = "https://rubygems.org/gems/wasmer" target = "_blank" > </ a > |  |
|  | [**Postgres** ](https://github.com/wasmerio/postgres-ext-wasm ) | | Wasmer | actively developed | < a href = "https://github.com/wasmerio/postgres-ext-wasm" target = "_blank" > </ a > |  |
|  | [**JavaScript** ](https://github.com/wasmerio/wasmer-js ) | [Docs ](https://docs.wasmer.io/wasmer-js/wasmer-js ) | Wasmer | actively developed | < a href = "https://www.npmjs.com/package/ @wasmer/wasi " target = "_blank" > </ a > |  |
|  | [**C#/.Net** ](https://github.com/migueldeicaza/WasmerSharp ) | [Docs ](https://migueldeicaza.github.io/WasmerSharp/ ) |[Miguel de Icaza ](https://github.com/migueldeicaza ) | actively developed | < a href = "https://www.nuget.org/packages/WasmerSharp/" target = "_blank" > </ a > |  |
|  | [**R** ](https://github.com/dirkschumacher/wasmr ) | [Docs ](https://github.com/dirkschumacher/wasmr#example ) | [Dirk Schumacher ](https://github.com/dirkschumacher ) | actively developed | |  |
|  | [**Elixir** ](https://github.com/tessi/wasmex ) | [Docs ](https://hexdocs.pm/wasmex/api-reference.html ) | [Philipp Tessenow ](https://github.com/tessi ) | actively developed | < a href = "https://hex.pm/packages/wasmex" target = "_blank" > </ a > |  |
| ❓ | [your language is missing? ](https://github.com/wasmerio/wasmer/issues/new?assignees=&labels=%F0%9F%8E%89+enhancement&template=---feature-request.md&title= ) | | | | |
2019-07-31 08:53:33 +09:00
2019-02-22 12:31:31 -08:00
2020-02-20 14:48:10 -08:00
## Contribute
2018-10-14 23:54:28 +02:00
2020-02-20 14:48:10 -08:00
**We welcome any form of contribution, especially from new members of our community** 💜
2018-10-14 23:54:28 +02:00
2020-02-20 14:48:10 -08:00
You can check how to build the Wasmer runtime in [our awesome docs ]([https://docs.wasmer.io/ecosystem/wasmer/building-from-source](https://new-docs.wasmer.io/ecosystem/wasmer/building-from-source ))!
2018-10-24 12:07:52 +02:00
2020-02-20 14:48:10 -08:00
### Testing
2018-12-07 11:25:31 -08:00
2020-02-20 14:48:10 -08:00
Test you want? The [Wasmer docs will show you how ](https://new-docs.wasmer.io/ecosystem/wasmer/building-from-source/testing ).
2018-12-07 11:25:31 -08:00
2020-02-20 14:48:10 -08:00
## Community
2018-12-07 11:25:31 -08:00
2020-02-20 14:48:10 -08:00
Wasmer has an amazing community developers and contributors. Welcome, please join us! 👋
2018-10-11 21:29:36 +02:00
2020-02-20 14:48:10 -08:00
### Channels
2018-12-19 13:00:07 -08:00
2020-02-20 14:48:10 -08:00
- [Slack ](https://slack.wasmer.io/ )
- [Twitter ](https://twitter.com/wasmerio )
- [Facebook ](https://www.facebook.com/wasmerio )
- [Email ](mailto:hello@wasmer.io )
