Skip to main content

Using the Elixir / Erlang Host SDK

1. Install the package​

Install via hex.pm:

For Mix:

{:extism, "~> 0.1.0"}
Rust Dependency

The extism package is writen in rust and the NIF must be compiled in your application with mix. Because of that, installing rust is currently a requirement. We recommend installing rustup.

2. Import the library and use the APIs​

Count Vowels Plugin

code.wasm in this example is our example plugin that counts vowels. If you want to run this, download it first and set the path:

curl https://raw.githubusercontent.com/extism/extism/main/wasm/code.wasm > code.wasm
require Extism

ctx = Extism.Context.new
# point to the count-vowels plugin on my machine
manifest = %{ wasm: [ %{ path: "code.wasm" } ]}
{:ok, plugin} = Extism.Context.new_plugin(ctx, manifest, false)
{:ok, output} = Extism.Plugin.call(plugin, "count_vowels", "this is a test")
JSON.decode!(output)
# => %{"count" => 4}

Need help?​

If you've encountered a bug or think something is missing, please open an issue on the Extism GitHub repository.

There is an active community on Discord where the project maintainers and users can help you. Come hang out!