gitwtfhub

wtf is node-llvm?

colesbury/node-llvm — explained in plain English

Analysis updated 2026-07-17 · repo last pushed 2014-08-06

★ 3C++Audience · developerComplexity · 4/5DormantSetup · hard

TL;DR

Node.js bindings for LLVM that let JavaScript build, compile, and run functions as fast machine code at runtime.

Mindmap

mindmap
  root((repo))
    What it does
      Wraps LLVM in JavaScript
      Builds functions step by step
      Compiles to machine code
    Tech stack
      C++
      Node.js
      LLVM
      Node-FFI
    Use cases
      Build a math expression evaluator
      Write a shader compiler
      Create a query optimizer
    Audience
      Developers
      Researchers
    Limitations
      No automatic memory free
      Requires LLVM 3.2

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Build a domain-specific language that compiles expressions to fast machine code from JavaScript.

REASON 2

Create a runtime math expression evaluator using LLVM instructions like createAdd and createMul.

REASON 3

Prototype a shader or query compiler that needs compiled-code speed with JavaScript control logic.

What's in the stack?

C++Node.jsLLVMNode-FFI

How it stacks up

colesbury/node-llvmbong-water-water-bong/npu-gpu-cpudahorg/wlameshot
Stars333
LanguageC++C++C++
Last pushed2014-08-06——
MaintenanceDormant——
Setup difficultyhardhardmoderate
Complexity4/55/53/5
Audiencedeveloperresearcherdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · hard Time to first run · 1h+

Requires LLVM 3.2 installed on the machine and Node-FFI to bridge compiled code to JavaScript.

No license info given in the explanation.

Yoink these prompts

Prompt 1
Walk me through the Kaleidoscope example and how it compiles math expressions using this library.
Prompt 2
Show me how to use createAdd, createMul, and createLoad to build a simple compiled function.
Prompt 3
What are the memory management limitations of this library, and how should I design around them?

Frequently asked questions

wtf is node-llvm?

Node.js bindings for LLVM that let JavaScript build, compile, and run functions as fast machine code at runtime.

What language is node-llvm written in?

Mainly C++. The stack also includes C++, Node.js, LLVM.

Is node-llvm actively maintained?

Dormant — no commits in 2+ years (last push 2014-08-06).

What license does node-llvm use?

No license info given in the explanation.

How hard is node-llvm to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is node-llvm for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.

Other repos in this lane