modular, offline-first voice assistant for MagicMirror² processes the user input using AI running locally or cloud.

Use this module to add a local LLM-powered voice assistant to your MagicMirror.

In your terminal, go to the modules directory and clone the repository:

cd ~/MagicMirror/modules
git clone https://github.com/rahil234/MMM-Assistant.git

Go to the module directory and pull the latest changes:

cd ~/MagicMirror/modules/MMM-Assistant
git pull

To use this module, you have to add a configuration object to the modules array in the config/config.js file.

Minimal configuration to use the module:

    {
        module: 'MMM-Assistant',
        position: 'lower_third'
    },

Configuration with all options:

    {
        module: "MMM-Assistant",
        position: "lower_third",
        config: {
          llmEndpoint: "http://localhost:11434/api/generate",
          model: "llama3.1:8b",
          systemPrompt: "You are a helpful voice assistant for a MagicMirror. Answer concisely.",
          responseClearDelay: 5000,
          volume: 0.5;
        }
    },

• npm install - Install devDependencies like ESLint.
• node --run lint - Run linting and formatter checks.
• node --run lint:fix - Fix linting and formatter issues.

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

All notable changes to this project will be documented in the CHANGELOG.md file.