Skip to content
processonePublic

About

Native Erlang Runtime Architecture

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

6 stars

Watchers

1 watching

Forks

nera — Erlang to native code

The goal is Erlang that ships like Go.

Nera compiles Erlang source into native executables that run without the BEAM virtual machine. It provides its own runtime for Erlang processes and message passing.

The compiler itself is a single executable: it embeds the matching runtime and standard-library sources, so you can copy just nera for native builds. You still need a C linker.

Experimental. Nera is not a drop-in replacement for Erlang/OTP and is not ready for production. The first release, v0.1.0, is experimental; Nera stays experimental until 1.0.

Before you try it

Nera is tested on macOS arm64 and Linux x86-64. The macOS x86-64 and Linux arm64 archives are cross-built but have not been run. Windows does not work yet.

Cowboy, TLS, distributed Erlang and hot code upgrades are not supported. Other OTP APIs are incomplete, and wrong results and hangs are still possible. Read the known limits and project compatibility before choosing a workload. A successful nera check does not establish that a program runs.

Try it

For a prebuilt compiler, choose an archive for your platform from GitHub Releases. You still need a C linker (cc) to compile Erlang programs. See the installation guide for archive setup.

To build from source, install Rust through rustup, Git and a C linker: Xcode Command Line Tools on macOS, or GCC/Clang on Linux. The checkout selects Rust 1.99.0.

Run this in a POSIX shell:

git clone https://github.com/processone/nera.git
cd nera
cargo build --release --locked -p nera-runtime
cargo build --release --locked -p nera
./target/release/nera build examples/hello.erl -e hello:start -o hello
./hello

Output:

Hello, World!

Build the runtime first so the compiler can embed the matching library. The -e hello:start option chooses hello:start/0 as the entry point; without it, Nera looks for main:start/0.

See the command reference for projects, dependencies, debugging and cross-compilation.

Examples

Start with the Erlang developer walkthroughs: a native program, linked processes, an OTP-style server and a JSON library. Each example states what it demonstrates and what it does not prove.

For smaller examples, see Hello World, ping-pong and the message-passing ring.

Editor tools

Nera provides diagnostics, formatting and navigation through its language server and integrations for VS Code, JetBrains and Emacs. You can use these tools while building and deploying with standard Erlang/OTP. Follow the editor's setup guide to configure the Nera executable.

Documentation and contributing

License

Apache License 2.0.

About

Native Erlang Runtime Architecture

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

6 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages