{"id":45357,"library":"madarx","title":"Madarx OS","description":"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.","status":"active","version":"2.24.1","language":"javascript","source_language":"en","source_url":"https://github.com/kareemodev777/madarx-os","tags":["javascript"],"install":[{"cmd":"npm install madarx","lang":"bash","label":"npm"},{"cmd":"yarn add madarx","lang":"bash","label":"yarn"},{"cmd":"pnpm add madarx","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Core framework; Madarx is a Next.js product","package":"next","optional":false},{"reason":"UI framework used by Next.js","package":"react","optional":false},{"reason":"SQLite binding for runtime (though node:sqlite also used)","package":"better-sqlite3","optional":true}],"imports":[{"note":"ESM-only — CommonJS require will fail. Ensure Node >=22.5.","wrong":"const madarx = require('madarx')","symbol":"madarx","correct":"import { madarx } from 'madarx'"},{"note":"Named export, not default. Available since v2.","wrong":"import createMadarx from 'madarx'","symbol":"createMadarx","correct":"import { createMadarx } from 'madarx'"},{"note":"TypeScript type export; use import type if only used as type.","wrong":null,"symbol":"MadarxConfig","correct":"import { MadarxConfig } from 'madarx'"}],"quickstart":{"code":"import { madarx } from 'madarx';\n\nconst os = await madarx.setup({\n  masterKey: process.env.MADARX_MASTER_KEY ?? '',\n  dataDir: process.env.MADARX_DATA_DIR ?? '~/.madarx'\n});\n\nawait os.boot();\n// Web dashboard at http://127.0.0.1:8787/\n// Cron daemon and heartbeat worker start automatically\n","lang":"typescript","description":"Demonstrates setup and boot of the Madarx OS runtime with optional env vars for master key and data directory."},"warnings":[{"fix":"Update Node.js to >=22.5 via nvm or official installer.","message":"Requires Node.js >=22.5 for built-in node:sqlite module; older versions cause runtime errors.","severity":"breaking","affected_versions":"all"},{"fix":"Pair a separate, non-personal phone number for WhatsApp bridge.","message":"WhatsApp bridge uses Baileys (unofficial library); paired number may be banned. Use a dedicated number, not personal.","severity":"gotcha","affected_versions":"all"},{"fix":"Backup ~/.madarx/ directory before upgrading major version.","message":"Data lives in ~/.madarx/; upgrades do not touch it, but manual backup recommended before major version bumps.","severity":"gotcha","affected_versions":">=2.0.0"},{"fix":"Remove better-sqlite3 from dependencies and rely on node:sqlite.","message":"Better-sqlite3 is optional; built-in node:sqlite is preferred in Node >=22.5.","severity":"deprecated","affected_versions":">=2.24.0"}],"env_vars":null,"search_vec":"'1':37 '2.24.1':31 '22.5':60 '6':38 'activ':32 'agent':64 'approv':23 'approval-g':22 'back':16 'background':69 'bridg':81 'bring':87 'bring-your-own-key':86 'built':54 'built-in':53 'chat':65 'cloud':49 'consol':83 'cron':19,70 'current':27 'daemon':20 'depend':50 'develop':33 'differenti':41 'durabl':72 'entir':43 'featur':61 'first':9 'gate':24 'hail':35 'heartbeat':73 'implement':39 'jarvi':84 'javascript':97 'key':40,90 'lane':96 'local':8,25,94 'local-first':7 'machin':46 'madarx':1,3 'main':63 'name':67 'next.js':10 'node':56,59 'node.js':52 'option':79 'orchestr':66 'os':2,4 'phase':36 'product':11 'realtim':91 'requir':58 'retry/backoff':76 'run':42 'runner':26 'runtim':17 'schedul':18,71 'sqlite':15,57 'sqlite-back':14 'stabl':28 'stt/tts':95 'support':85 'tts':92 'use':51 'version':29 'voic':82 'whatsapp':80 'worker':68,74","created_at":"2026-06-07T12:54:36.987698+00:00","updated_at":"2026-06-07T12:54:36.987698+00:00","problems":[{"fix":"Upgrade Node.js to >=22.5.0.","cause":"Node.js version below 22.5 does not support the built-in node:sqlite module.","error":"Error: Cannot find module 'node:sqlite'"},{"fix":"Use import syntax: import { madarx } from 'madarx'.","cause":"Madarx is ESM-only; using require() instead of import fails.","error":"ERR_REQUIRE_ESM: require() of ES Module not supported"},{"fix":"Use { madarx } or { createMadarx } named import.","cause":"Wrong import style used (default import instead of named).","error":"TypeError: Cannot read properties of undefined (reading 'boot')"}],"ecosystem":"npm","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"https://github.com/kareemodev777/madarx-os#readme","github":"https://github.com/kareemodev777/madarx-os","docs":null,"changelog":null,"pypi":null,"npm":"madarx","openapi_spec":null,"status_page":null,"smithery":null,"categories":["ai-ml","productivity"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-07","next_check":"2026-09-05","install_tag":null}}