npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

homebridge-ai-2.0-plugin

v2.0.2

Published

AI Assistant plugin for Homebridge

Downloads

139

Readme

Homebridge AI Assistant Plugin

The Homebridge AI Assistant adds advanced AI capabilities to your Homebridge setup using OpenAI's GPT models. Control your smart home with natural language, automate routines, and let the AI learn your habits to enhance your smart home experience.

Features

  • Natural Language Commands: Control your devices using simple, conversational language.
  • Device Discovery: Automatically detects and integrates all HomeKit-compatible accessories.
  • AI Learning: Learns your device usage patterns to suggest automations and scenes.
  • Automation Suggestions: Receive AI-generated suggestions for routines and scenes based on your habits.
  • Voice and Text Interface: Communicate with the AI Assistant via voice commands or text input.
  • Comprehensive Device Support: Supports lights, switches, thermostats, sensors, locks, fans, and more.
  • Customizable Settings: Configure AI models, trigger phrases, and enable/disable features to suit your needs.

Installation

  1. Install the Plugin:

    sudo npm install -g homebridge-ai-2.0-plugin
  2. Obtain OpenAI API Key:

  3. Configure the Plugin:

    • Open your Homebridge UI.
    • Navigate to Plugins > Homebridge AI Assistant > Settings.
    • Paste your OpenAI API Key.
    • Adjust other settings as desired.
    • Save and restart Homebridge.

Usage

Voice Commands

  • Use the Command Trigger Phrase (default: "Hey Home") followed by your command.
  • Examples:
    • "Hey Home, turn on the living room lights and set them to blue."
    • "Hey Home, set the thermostat to 72 degrees."

Text Commands

  • Use the Homebridge UI or any integrated text interface to send commands.
  • Enter your command without the trigger phrase.

AI-generated Automations

  • The assistant learns your habits and suggests automations.
  • View and manage suggestions in the Homebridge UI under AI Assistant > Suggestions.
  • Accept or reject suggestions based on your preference.

Supported Devices

The plugin supports a wide range of devices:

  • Lighting: Lightbulbs, LED strips.
  • Switches and Outlets.
  • Climate Control: Thermostats, heaters, air conditioners.
  • Sensors: Temperature, humidity, motion, contact sensors.
  • Security: Locks, security systems, garage door openers.
  • Fans and Window Coverings.
  • Scenes and Routines: Create and manage scenes.

Example Commands

  • Device Control:
    • "Hey Home, dim the bedroom lights to 50%."
    • "Hey Home, lock the front door."
  • Scene Creation:
    • "Hey Home, create a 'Movie Night' scene with the lights off and TV on."
  • Automation Requests:
    • "Hey Home, set up an automation to turn on the porch light at sunset."
  • Status Inquiries:
    • "Hey Home, is the garage door open?"
    • "Hey Home, what's the temperature inside?"

Configuration Options

  • AI Model: Choose between GPT-4 and GPT-3.5 Turbo.
  • Command Trigger Phrase: Customize the phrase that triggers the AI assistant.
  • Enable Voice Commands: Toggle voice command processing.
  • Enable Learning: Allow the AI to learn from your device usage patterns.
  • Enable Automation Suggestions: Receive suggestions for automations.
  • Debug Mode: Enable detailed logging for troubleshooting.

Updating the Plugin

To update the plugin to the latest version:

sudo npm update -g homebridge-ai-2.0-plugin

After updating, restart Homebridge.

Uninstalling the Plugin

To uninstall the plugin completely:

sudo npm uninstall -g homebridge-ai-2.0-plugin

Then, remove the plugin's configuration from your config.json or through the Homebridge UI.

Troubleshooting

  • Invalid API Key: Ensure your OpenAI API key is correct and has sufficient privileges.
  • Network Issues: Verify that Homebridge has internet access and can reach the OpenAI API.
  • Device Not Responding: Check that your accessories are functioning correctly and are supported.
  • Logging: Enable Debug Mode in the plugin settings to view detailed logs.

Support and Contribution

  • Issues: For issues or feature requests, open an issue on GitHub.
  • Contributing: Contributions are welcome! Please submit pull requests to the develop branch.

Privacy and Data Usage

Your privacy is important. The plugin:

  • Sends commands and device information to OpenAI servers for processing.
  • Stores AI suggestions locally on your Homebridge server.
  • Does not share personal data with third parties other than OpenAI.

Review OpenAI's privacy policy for more details.

License

This project is licensed under the MIT License - see the LICENSE file for details.