@hpcc-js/wasm

This repository contains a collection of useful c++ libraries compiled to WASM for (re)use in Node JS, Web Browsers and JavaScript Libraries:

• base91 - v0.6.0
• duckdb - v1.5.6
• expat - v2.8.2
• graphviz - 16.1.0
• llama.cpp - b10437
• NeuralAmpModelerCore - v0.5.4
• zstd - v1.5.7
• ...more to follow...

Built with:

• emsdk - v6.0.10
• vcpkg - 2026.07.29

Homepage and Documents

• Homepage
  • Base91
  • DuckDB
  • Expat
  • Graphviz
  • Graphviz CLI
  • Llama
  • Llama CLI
  • NeuralAmpModelerCore
  • Zstd

AI Assistant / Copilot Instructions

This repository includes comprehensive instructions for AI assistants and GitHub Copilot:

• Main Instructions - Repository overview and architecture
• Development Workflow - Step-by-step development processes
• Package Patterns - Common patterns and quick reference
• Troubleshooting Guide - Debugging and problem resolution
• Package-specific guides in packages/*/ directories

Packages

This repository is a monorepo with the following packages:

• @hpcc-js/wasm-base91
• @hpcc-js/wasm-duckdb
• @hpcc-js/wasm-expat
• @hpcc-js/wasm-graphviz
• @hpcc-js/wasm-graphviz-cli
• @hpcc-js/wasm-llama
• @hpcc-js/wasm-llama-cli
• @hpcc-js/wasm-nam-core
• @hpcc-js/wasm-zstd
• @hpcc-js/wasm (meta package for backward compatibility)

Quick Start

import { Base91 } from "@hpcc-js/wasm-base91";
import { Graphviz } from "@hpcc-js/wasm-graphviz";
import { Zstd } from "@hpcc-js/wasm-zstd";

// Graphviz  ---
async function dot2svg() {
  const graphviz = await Graphviz.load();
  console.log("svg:  ", graphviz.dot("digraph G { Hello -> World }"));
}

dot2svg();

// Base91 + Zstd ---
const text =
  "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed non risus. Suspendisse lectus tortor, dignissim sit amet, adipiscing nec, ultricies sed, dolor. Cras elementum ultrices diam. Maecenas ligula massa, varius a, semper congue, euismod non, mi.  Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed non risus. Suspendisse lectus tortor, dignissim sit amet, adipiscing nec, ultricies sed, dolor. Cras elementum ultrices diam. Maecenas ligula massa, varius a, semper congue, euismod non, mi.";
const data = new TextEncoder().encode(text);

async function compressDecompress() {
  const zstd = await Zstd.load();
  const compressed_data = zstd.compress(data);
  const base91 = await Base91.load();
  const base91Str = base91.encode(compressed_data);

  const compressed_data2 = base91.decode(base91Str);
  const data2 = zstd.decompress(compressed_data2);
  const text2 = new TextDecoder().decode(data2);

  console.log("Text Length:  ", text.length);
  console.log("Compressed Length:  ", compressed_data.length);
  console.log("Base91 Length:  ", base91Str.length);
  console.log("Passed:  ", text === text2);
}

compressDecompress();

Quick Migration from v1

v1.x.x

import { graphviz, wasmFolder } from "@hpcc-js/wasm";

wasmFolder("https://cdn.jsdelivr.net/npm/@hpcc-js/wasm/dist");

const dot = "digraph G { Hello -> World }";

graphviz.dot(dot).then((svg) => {
  const div = document.getElementById("placeholder");
  div.innerHTML = svg;
});

graphvizVersion.then((version) => console.log(version));

v2.x.x

import { Graphviz } from "@hpcc-js/wasm";

const dot = "digraph G { Hello -> World }";

Graphviz.load().then((graphviz) => {
  const svg = graphviz.dot(dot);
  const div = document.getElementById("placeholder");
  div.innerHTML = svg;

  console.log(graphviz.version());
});

Notes:

• wasmFolder is no longer needed
• All wasm libraries have the same asynchronous load pattern
  • const instance = await <Wasm>.load();

v3.x.x

import { Graphviz } from "@hpcc-js/wasm-graphviz";

const dot = "digraph G { Hello -> World }";

Graphviz.load().then((graphviz) => {
  const svg = graphviz.dot(dot);
  const div = document.getElementById("placeholder");
  div.innerHTML = svg;

  console.log(graphviz.version());
});

Build Instructions

The following instructions are for building the entire repository from scratch. In general the instructions assume you are running from within a bash terminal.

• Windows (With WSL2 and Git Bash installed)
• Linux (native or WSL2)
• MacOS
• Docker

Pre-requisites

To get an idea of what pre-requisites are required, please see the following files:

• Dockerfile
• GH Action Ubuntu
• Node.js (CI runs Node.js 22 and 24; docs deploy uses Node.js 20)

Steps (Docker)

git clone https://github.com/hpcc-systems/hpcc-js-wasm.git
cd hpcc-js-wasm
npm ci
npm run build-docker

Steps (Windows, Linux, MacOS)

git clone https://github.com/hpcc-systems/hpcc-js-wasm.git
cd hpcc-js-wasm
npm ci
npm run install-build-deps
npm run build