madarx

library2.24.1jsnpmunverified

Madarx OS is a local-first Next.js product with an SQLite-backed runtime, scheduled cron daemon, and approval-gated local runners. Current stable version is 2.24.1, actively developed with HAIL Phases 1–6 implemented. Key differentiators: runs entirely on your machine with no cloud dependence; uses Node.js built-in node:sqlite (requires Node >=22.5); features a Main Agent chat orchestrating named workers, background cron scheduler, durable heartbeat worker with retry/backoff, and an optional WhatsApp bridge. Voice console (Jarvis) supports bring-your-own-key realtime, TTS, or local STT/TTS lanes.

ai-ml productivity

npm install madarx

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · MADARX

madarx

ai-mljavascriptv2.24.1

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

madarx

✓ import { madarx } from 'madarx'

✗ const madarx = require('madarx')

ESM-only — CommonJS require will fail. Ensure Node >=22.5.

createMadarx

✓ import { createMadarx } from 'madarx'

✗ import createMadarx from 'madarx'

Named export, not default. Available since v2.

MadarxConfig

✓ import { MadarxConfig } from 'madarx'

TypeScript type export; use import type if only used as type.

Demonstrates setup and boot of the Madarx OS runtime with optional env vars for master key and data directory.

import { madarx } from 'madarx'; const os = await madarx.setup({ masterKey: process.env.MADARX_MASTER_KEY ?? '', dataDir: process.env.MADARX_DATA_DIR ?? '~/.madarx' }); await os.boot(); // Web dashboard at http://127.0.0.1:8787/ // Cron daemon and heartbeat worker start automatically

Debug

Known issues

breakingRequires Node.js >=22.5 for built-in node:sqlite module; older versions cause runtime errors.

fix

Update Node.js to >=22.5 via nvm or official installer.

affects: all

gotchaWhatsApp bridge uses Baileys (unofficial library); paired number may be banned. Use a dedicated number, not personal.

fix

Pair a separate, non-personal phone number for WhatsApp bridge.

affects: all

gotchaData lives in ~/.madarx/; upgrades do not touch it, but manual backup recommended before major version bumps.

fix

Backup ~/.madarx/ directory before upgrading major version.

affects: >=2.0.0

deprecatedBetter-sqlite3 is optional; built-in node:sqlite is preferred in Node >=22.5.

fix

Remove better-sqlite3 from dependencies and rely on node:sqlite.

affects: >=2.24.0

Errors

Common errors & fixes

Error: Cannot find module 'node:sqlite'

Node.js version below 22.5 does not support the built-in node:sqlite module.

fix

Upgrade Node.js to >=22.5.0.

ERR_REQUIRE_ESM: require() of ES Module not supported

Madarx is ESM-only; using require() instead of import fails.

fix

Use import syntax: import { madarx } from 'madarx'.

TypeError: Cannot read properties of undefined (reading 'boot')

Wrong import style used (default import instead of named).

fix

Use { madarx } or { createMadarx } named import.

Upgrade

Version history

2.24.1latest on npm

Audit

Dependencies

nextrequiredCore framework; Madarx is a Next.js product

reactrequiredUI framework used by Next.js

better-sqlite3optionalSQLite binding for runtime (though node:sqlite also used)

Agent activity

25 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/kareemodev777/madarx-os ↗

packagemadarx ↗

homepagehttps://github.com/kareemodev777/madarx-os#readme ↗