Node-RED Companion Integration

Companion Component to node-red-contrib-home-assistant-websocket for seamless integration of Node-RED with Home Assistant.

Overview

The Node-RED Companion Integration bridges Node-RED and Home Assistant, allowing you to manage Home Assistant entities and automations directly from Node-RED. This integration enhances your smart home automation setup by enabling dynamic interaction between these two powerful tools.

Key Features

• Entity Management:
  • Create and update Home Assistant entities from Node-RED, including:
    • Binary Sensors
    • Buttons
    • Numbers
    • Selects
    • Sensors
    • Switches
    • Text fields
• Flow Control:
  • Enable or disable Node-RED flows directly from the Home Assistant UI.
• Webhooks:
  • Create and manage Home Assistant webhooks, with handling in Node-RED.
• Device Automation:
  • Utilize device triggers and actions within Node-RED for advanced automation capabilities.

Minimum Requirements

• node-red-contrib-home-assistant-websocket v0.57+
• Home Assistant 2024.5+

Installation

Option 1: HACS (Home Assistant Community Store)

Navigate to the integration

Manual instructions

1. Navigate to HACS.
2. Search for "hass-node-red".
3. Click on the result.

Install the integration

1. Click the blue "Download" button on the bottom right.
2. Click "Download" in the version selection popup to download the latest version.
3. Restart Home Assistant. There will be a clickable repair item for this in "Settings".

Install the device

Manual instructions

1. Go to "Settings" in the Home Assistant sidebar, then select "Devices & Services".
2. Click the blue [+ Add Integration] button at the bottom right, search for "Node-RED Companion", and click it.

Follow any steps in the on-screen prompts.

Option 2: Manual Installation

For manual installation:

1. Access your Home Assistant configuration directory (configuration.yaml location).
2. If it doesn’t already exist, create a custom_components directory.
3. Within custom_components, create a new folder named nodered.
4. Download all files from the custom_components/nodered/ directory in this repository.
5. Place these files in the newly created nodered directory.
6. Restart Home Assistant.
7. Refresh your browser window.
8. From "Settings" in the Home Assistant sidebar, select "Devices & Services", click the blue [+ Add Integration] button, search for "Node-RED Companion", and install it.
   

Configuration

Once the Node-RED Companion Integration is installed and added via Home Assistant Integrations, all further configuration is managed from within Node-RED.

Contributing

Contributions are welcome! If you're interested in contributing, please review our Contribution Guidelines before submitting a pull request or issue.

Support

If you find this project helpful and want to support its development, consider buying me a coffee!

---