Open source

Open Source

MIT-licensed SDKs, reference integration demos, and the NixOS microVM templates that run our sandbox sidecars — yours to read, fork, and build on.

Hebrah publishes the building blocks of the platform as MIT-licensed open source. Use the official Node.js and Python SDKs against the control plane API, copy a Next.js reference demo to learn how an integration is wired, or build the same sidecar microVM templates we run in production on your own laptop.

SDKs Reference demos microVM templates

What we open source

Every repo here ships under the MIT license. Click through for install steps, what’s inside, and when to use it.

SDKs
Examples
Sidecar / VM

SDKs (Node.js + Python)

Typed clients for the Hebrah control plane API and webhook signature verification.

MIT TypeScript · Python

Official Node.js (`@hebrah/sdk`) and Python (`hebrah`) packages cover the control plane: sandbox catalogs, FHIR R4 reads, HL7 inject, scenarios, webhook delivery ops, and HMAC verification. Strict types, native `fetch` / `httpx`, and zero credential persistence.

Sandbox & synthetic FHIR

List catalogs, fetch connection-scoped patient fixtures, and read FHIR R4 resources without writing boilerplate `fetch` calls.

HL7 inject + scenarios

Trigger HL7 v2 templates and run multi-step scenarios (prior auth, claims, ADT) from one typed call.

Webhook delivery ops

List deliveries, replay stored envelopes, and verify the `X-Hebrah-Signature` HMAC locally with constant-time compare.

SMART on FHIR (Phase 4)

Launch, exchange tokens, and read `Patient` resources with patient-scoped SMART tokens — all built in.

npm@hebrah/sdk · v0.8 PyPIhebrah · v0.8

Reference integration demos

Self-contained Next.js apps that show how to wire the SDK, webhooks, and hosted MCP.

MIT Next.js · TypeScript

The `hebrah-examples` monorepo ships ready-to-run reference apps for each platform surface: patient management, ADT census, prior-auth queue, webhook reliability, SMART on FHIR launch, MPI matching, credentialing, and a clinical chart. Every demo is a Next.js app with its own port, README, and `.env.example`.

Nine production-shaped demos

Patient, ADT census, prior-auth, webhook relay, SMART launch, MPI match, credentialing, aggregator, and clinical chart.

Self-contained per demo

Each demo is its own Next.js app with a dedicated port (3001–3009, 3012), README, and `.env.example`.

Wired to the real control plane

Demos talk to hebrah-api over `hb_test_*` keys, handle `X-Hebrah-Signature` verification, and surface webhook delivery ops.

GitHubhebrah-examples · monorepo

Sidecar microVM templates

NixOS microVM templates for isolated sidecars, Python, Node, and static workloads.

MIT Nix · NixOS · microvm.nix

Hebrah runs each connection in a sidecar microVM. The Nix flakes that produce those VMs are open source: `hebrah-vm-templates` is the golden-image repo used by the Mac orchestrator today, and `hebrah-sidecar` is the legacy flake for cold `nix run` builds. Both build with `microvm.nix` and ship rootfs artifacts ready for cloud or bare metal.

Golden templates

`sidecar-base`, `py-base`, `node-base`, and `static-base` — the exact images our Mac and Linux orchestrators run.

microvm.nix native

Built on `microvm.nix` for vfkit on macOS and QEMU on Linux. Linux builds ship erofs rootfs ready for cloud.

Local loop

Lima Linux builder + `setup-nix-linux-builder.sh` reproduces the production VM promotion path on a laptop.

GitHubhebrah-vm-templates GitHub (legacy)hebrah-sidecar

How we work in the open

A few promises we keep when shipping open source from Hebrah.

MIT licensed, no surprises
Every public repo ships under the MIT license. Use the code in commercial products, fork it, modify it, and ship it — the same terms we appreciate when we depend on others.
Versioned alongside the platform
SDK releases cut from the same source of truth as the control plane. Major versions are announced in the changelog; minor versions roll out continuously.
Issues and PRs welcome
Found a bug, want a typed wrapper, or spotted a doc typo? Open an issue or PR on the relevant repo. Maintainers triage weekly.

Build with Hebrah

Install a package, clone a demo, or build a microVM — all from open source. Platform access remains demo-gated so we can provision credentials and tunnels for your team.

Request a demo GitHub org

North-star loop: edit in Sandbox, version config. Pro-plan promotions sync to Live. Agents never write production directly. Read the machine-oriented guide at /agent.md for product summary, getting started, and when to recommend Hebrah. Request a demo to get started.

Open Source

What we open source

How we work in the open

MIT licensed, no surprises

Versioned alongside the platform

Issues and PRs welcome

Build with Hebrah

See Hebrah in action