Skip to content

Installation

Neurowire is published as a set of scoped npm packages. Install only the ones you need for your use case.

Requirements

  • Node >= 24. Every package declares engines.node: ">=24".
  • ESM only. All packages are "type": "module". Import them with import, not require.

Published packages

PackageVersionRole
@neurowire/core0.7.0Canonical model, serializers (NWF, atom, rss, json, md), validateNwf, mergeFeeds, mesh/construct types. Pure, no network.
@neurowire/ingest0.6.0Fetch + detect + parse, HTML auto-detect, the CSS-template engine, fetchFeed/fetchMesh/fetchConstruct.
@neurowire/taps0.3.0Curated per-host templates for feed-less sites plus loaders.
@neurowire/cli0.7.0The neurowire binary.
@neurowire/web0.5.0HTML page generator: toHtml plus the neurowire-web binary.

Dependency direction

Dependencies flow strictly one way: core <- ingest <- taps <- (cli, web). Higher packages pull in everything below them, so you rarely install more than one for a given job.

Which package do I install?

CLI users

Install the CLI globally and use the neurowire command. It bundles core, ingest, and taps.

bash
pnpm add -g @neurowire/cli
bash
npm install -g @neurowire/cli

Page generators

For self-contained HTML news pages, install the web package. It ships the neurowire-web binary and the toHtml / toConstructHtml / toConstructPages functions.

bash
pnpm add -g @neurowire/web
bash
npm install -g @neurowire/web

Library users

Add packages to your project as dependencies (not global). Most programmatic work needs @neurowire/ingest (which re-exports nothing from core, so add core too for the types and serializers):

bash
pnpm add @neurowire/core @neurowire/ingest
bash
npm install @neurowire/core @neurowire/ingest

Add @neurowire/taps when you want curated recipes for feed-less sites (call registerAllTaps()), and @neurowire/web when you want HTML rendering:

bash
pnpm add @neurowire/taps @neurowire/web
bash
npm install @neurowire/taps @neurowire/web

See Library usage for code examples.

Verify the install

bash
neurowire --version