Hi everyone,
I’d like to share Node.js NPX, a community Home Assistant app that provides a persistent Node.js, npm and npx environment directly on Home Assistant OS.
The goal is to make it easier to run Node.js-based tools, scripts and long-running services without modifying the Home Assistant OS host.
Features
- Persistent npm packages and Node.js tools across app restarts and updates
- Custom startup commands and configurable npm package versions
- Bundled Chromium for Puppeteer-based tools
- Optional automatic package updates
- Optional localhost Home Assistant API bridge for entity states, diagnostics and service calls
- Optional write access through the bridge, disabled by default
- Prebuilt AMD64 container images published through GitHub Container Registry
Installation
Add the following repository in the Home Assistant App Store:
Then install Node.js NPX.
Example
command: “”
package: “cowsay”
version: “latest”
arguments: “Hello Home Assistant”
auto_update: false
homeassistant_bridge: false
homeassistant_write_access: false
Security
The app can execute third-party npm packages and arbitrary configured commands. Only run software you trust.
The optional Home Assistant bridge is disabled by default. The app currently retains Supervisor manager permissions for advanced diagnostics, independently of the bridge settings. Please review these permissions before installing.
Project
GitHub: GitHub - Diwie/homeassistant-npx: Node.js, npm and npx environment for Home Assistant OS · GitHub
License: GNU GPL-3.0-or-later (Copyleft)
The project is open source. Feedback, bug reports and contributions are welcome!