2020-02-20 22:48:10 +00:00
2020-02-29 17:35:45 +00:00
< div align = "center" >
2019-02-20 00:01:44 +00:00
< a href = "https://wasmer.io" target = "_blank" rel = "noopener noreferrer" >
2020-02-20 22:48:10 +00:00
< img width = "300" src = "https://raw.githubusercontent.com/wasmerio/wasmer/master/assets/logo.png" alt = "Wasmer logo" >
2019-02-20 00:01:44 +00:00
< / a >
2020-02-29 17:35:45 +00:00
< p >
< 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" >
< / a >
< a href = "https://slack.wasmer.io" >
2020-02-29 17:39:53 +00:00
< img src = "https://img.shields.io/static/v1?label=Slack&message=join%20chat&color=brighgreen&style=flat-square" alt = "Slack channel" >
2020-02-29 17:35:45 +00:00
< / a >
< a href = "https://github.com/wasmerio/wasmer/blob/master/LICENSE" >
< img src = "https://img.shields.io/github/license/wasmerio/wasmer.svg?style=flat-square" alt = "License" >
< / a >
< / p >
< h3 >
< a href = "https://wasmer.io/" > Website< / a >
< span > • < / span >
< a href = "https://docs.wasmer.io" > Docs< / a >
< span > • < / span >
< a href = "https://medium.com/wasmer/" > Blog< / a >
< span > • < / span >
< a href = "https://twitter.com/wasmerio" > Twitter< / a >
2020-05-08 07:00:34 +00:00
< span > • < / span >
< a href = "https://slack.wasmer.io/" > Community Chat< / a >
2020-02-29 17:35:45 +00:00
< / h3 >
< / div >
2020-02-29 17:47:00 +00:00
< br / >
2020-02-29 17:36:41 +00:00
2020-02-29 17:41:31 +00:00
[Wasmer ](https://wasmer.io/ ) is a standalone [WebAssembly ](https://webassembly.org/ ) runtime:
2020-02-29 17:35:45 +00:00
* **Universal**: Wasmer is available in *Linux, macOS and Windows* (for both Desktop and [ARM ](https://medium.com/wasmer/running-webassembly-on-arm-7d365ed0e50c ))
* **Fast**: Wasmer aims to run WebAssembly at near-native speed
* **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 14:50:09 +00:00
2020-02-20 22:48:10 +00:00
It is used to run software fast, universally and safely: standalone applications and universal libraries.
2020-01-15 14:50:09 +00:00
2020-02-20 22:48:10 +00:00
## Contents
2019-08-01 01:09:23 +00:00
2020-02-20 22:48:10 +00:00
- [Quickstart ](#quickstart )
2020-02-29 17:35:45 +00:00
- [Language Integrations ](#language-integrations )
2020-02-20 22:48:10 +00:00
- [Contribute ](#contribute )
- [Community ](#community )
2019-09-01 08:56:23 +00:00
2020-02-20 22:48:10 +00:00
## Quickstart
2019-09-01 08:56:23 +00:00
2020-02-20 22:48:10 +00:00
Get started with Wasmer:
2019-01-24 22:50:29 +00:00
2020-02-20 22:48:10 +00:00
#### 1. Install Wasmer
2018-10-14 21:49:10 +00:00
```sh
2020-02-20 22:48:10 +00:00
curl https://get.wasmer.io -sSfL | sh
2019-01-23 05:22:23 +00:00
```
2020-02-20 22:48:10 +00:00
> Note: *Wasmer is also [available on Windows](https://github.com/wasmerio/wasmer/releases)*
2019-07-25 00:42:03 +00:00
< details >
2020-02-20 22:48:10 +00:00
< summary > < b > Alternative< / b > : Install with Homebrew< / summary >
2019-07-25 00:42:03 +00:00
< p >
2019-01-23 05:22:23 +00:00
2019-04-01 07:48:32 +00:00
```sh
2020-02-20 22:48:10 +00:00
brew install wasmer
2019-04-01 07:48:32 +00:00
```
2019-10-01 02:47:10 +00:00
2020-02-20 22:48:10 +00:00
< / p >
2019-07-25 00:42:03 +00:00
< / details >
2020-02-20 22:48:10 +00:00
#### 2. Use Wasmer
2019-01-23 05:22:23 +00:00
2020-02-20 22:48:10 +00: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-10-01 02:47:10 +00:00
2020-02-20 22:48:10 +00:00
```bash
wasmer qjs.wasm
2019-07-06 01:57:30 +00:00
```
2020-02-20 22:48:10 +00:00
#### 3. Next steps
2019-08-22 18:26:23 +00:00
2020-02-20 22:48:10 +00:00
Here is what you can do next:
2019-10-01 02:47:10 +00:00
2020-02-20 22:48:10 +00: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 19:29:36 +00:00
2019-08-01 04:11:29 +00:00
2020-02-20 22:48:10 +00:00
### Language Integrations
2018-10-14 21:49:10 +00:00
2020-02-20 22:48:10 +00:00
Wasmer runtime can be used as a library embedded in different languages, so you can **use WebAssembly anywhere** 🎉
2018-10-24 10:07:52 +00:00
2020-02-20 22:48:10 +00: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-30 23:53:33 +00:00
2019-02-22 20:31:31 +00:00
2020-02-20 22:48:10 +00:00
## Contribute
2018-10-14 21:54:28 +00:00
2020-02-20 22:48:10 +00:00
**We welcome any form of contribution, especially from new members of our community** 💜
2018-10-14 21:54:28 +00:00
2020-02-20 23:08:26 +00:00
You can check how to build the Wasmer runtime in [our awesome docs ](https://docs.wasmer.io/ecosystem/wasmer/building-from-source )!
2018-10-24 10:07:52 +00:00
2020-02-20 22:48:10 +00:00
### Testing
2018-12-07 19:25:31 +00:00
2020-02-20 23:08:26 +00:00
Test you want? The [Wasmer docs will show you how ](https://docs.wasmer.io/ecosystem/wasmer/building-from-source/testing ).
2018-12-07 19:25:31 +00:00
2020-02-20 22:48:10 +00:00
## Community
2018-12-07 19:25:31 +00:00
2020-02-20 22:48:10 +00:00
Wasmer has an amazing community developers and contributors. Welcome, please join us! 👋
2018-10-11 19:29:36 +00:00
2020-02-20 22:48:10 +00:00
### Channels
2018-12-19 21:00:07 +00:00
2020-02-20 22:48:10 +00:00
- [Slack ](https://slack.wasmer.io/ )
- [Twitter ](https://twitter.com/wasmerio )
- [Facebook ](https://www.facebook.com/wasmerio )
- [Email ](mailto:hello@wasmer.io )
