https://github.com/digital-alchemy-ts/synapse-extension
Custom component counterpart, powering the synapse library. Creates and manages entities within Home Assistant
https://github.com/digital-alchemy-ts/synapse-extension
custom-components digital-alchemy hacs-integration home-assistant home-automation
Last synced: 8 months ago
JSON representation
Custom component counterpart, powering the synapse library. Creates and manages entities within Home Assistant
- Host: GitHub
- URL: https://github.com/digital-alchemy-ts/synapse-extension
- Owner: Digital-Alchemy-TS
- Created: 2024-02-16T17:49:16.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-07-12T00:48:47.000Z (11 months ago)
- Last Synced: 2025-07-12T03:08:00.682Z (11 months ago)
- Topics: custom-components, digital-alchemy, hacs-integration, home-assistant, home-automation
- Language: Python
- Homepage: https://docs.digital-alchemy.app
- Size: 99.6 KB
- Stars: 5
- Watchers: 1
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
Awesome Lists containing this project
README
## 📘 Description
Welcome to the Synapse custom component for Home Assistant!
This library works with [@digital-alchemy/synapse](https://github.com/Digital-Alchemy-TS/synapse) to allow Typescript based applications to create custom entities.
- [Extended docs](https://docs.digital-alchemy.app/Synapse-Extension)
- [Discord](https://discord.gg/JkZ35Gv97Y)
### 📦 Via HACS (Recommended)
1. Ensure you have [HACS](https://hacs.xyz/) installed in Home Assistant.
2. Open HACS from the Home Assistant sidebar.
3. In the top/right corner menu of the HACS screen click "Custom repositories."
4. Add github repository: `https://github.com/Digital-Alchemy-TS/synapse-extension`
5. For type select "Integration."
6. Click ADD. Then click Cancel to dismiss window.
7. Restart Home Assistant to apply the changes.
### 📁 Manual Installation
If you prefer or need to install the integration manually:
1. Clone or download this repository.
2. Copy the `custom_components/synapse/` directory from the repository into the `/custom_components/` directory of your Home Assistant installation.
3. Restart Home Assistant.
## 📖 Usage
Once enabled, the Synapse integration automatically coordinates with the connected Node.js application to manage entities. This includes generating unique IDs, tracking history, and ensuring entities appear on dashboards and persist across Home Assistant restarts.
Switches can be manipulated via the Lovelace UI or service domain calls, just like native Home Assistant switches. Sensors follow a push model, with updates sent from the Node.js application to Home Assistant.
For more advanced automation and entity grouping, refer to `@digital-alchemy/automation`, which provides tools for creating "rooms" and managing entity states and scene activation.
## 📚 Documentation and Support
For more detailed documentation and support, visit the [GitHub repository](https://github.com/Digital-Alchemy-TS/synapse-extension). Please report any issues or feature requests there.