Skip to content
Switch branches/tags

Latest commit

Increased the size of the AtomVM image partition (factory) to 1.75mb, and
decreased the size of the AtomVM library partition (data) to 256k.
No user-interface changes.

This change makes room for VM images that are bigger than 1MB.  The current
AtomVM library is just under 50k, so a 256k partition should be ample room for
core libraries to grow fivefold.

These changes are made under the terms of the LGPL v2.1 (or any later version)
and Apache 2.0 licenses.

Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Brings meme languages AESTHETICS to really small systems.

AtomVM implements from scratch a minimal Erlang VM that supports a subset of ErlangVM features and that is able to run unmodified BEAM binaries on really small systems like MCUs.


Supported Platforms

  • Linux
  • Darwin (MacOS)
  • FreeBSD
  • ESP32 SoC (with IDF and FreeRTOS software platforms, see README.ESP32.Md)
  • STM32 MCUs (with LibOpenCM3, see README.STM32.Md)

AtomVM aims to be easily portable to a new platform with a minimum effort, so more platforms might be supported in a near future.

Getting Started (on Linux)

$ mkdir build
$ cd build
$ cmake ..
$ make
$ ./src/AtomVM ./examples/erlang/hello_world.avm

Project Status

Build Status

Right now only binaries compiled with OTP 20-23 are supported.

AtomVM is still in its early stages, but it can run simple applications similar to those available in examples and tests. AtomVM might crash with a similar message:

Undecoded opcode: 15
Aborted (core dumped)

This basically means that an instruction has not been implemented yet, or that an outdated version has been used. Please, make sure to always run AtomVM using latest version.

Known limitations

This project is a work in progress, so there are several known limitations, that will prevent to run unmodified software, some of them are:

  • There is a minimal standard library, so several standard functions are missing.
  • Several instructions are not yet implemented.

All of these limitations are going to be fixed in a reasonable amount of time.