🧩 Plugins installieren

Was sind Plugins?

Plugins sind Python-Module, die die Fähigkeiten deines Nodes erweitern. Sie stellen neue "Skills" bereit, die die KI beim Antworten aufrufen kann. Möchte der Assistent zum Beispiel aktuelle Wetterdaten, ruft er das Wetter-Plugin auf.

Plugins sind vollständig isoliert und können nur über die definierte Plugin-API mit dem System interagieren — kein unkontrollierter Systemzugriff.

Mitgelieferte Plugins

Aus dem Marketplace installieren

1. Plugin-Manager öffnen

   Dashboard: Einstellungen → Plugins → Reiter "Marketplace".

2. Plugin suchen

   Durchsuche die verfügbaren Community-Plugins nach Name oder Kategorie. Klicke auf ein Plugin für Details, Screenshots und Bewertungen.

3. Installieren

   Klicke auf "Installieren". HiveMind lädt das Plugin aus dem GitHub-Repository und installiert alle Abhängigkeiten automatisch.

4. Plugin aktivieren

   Nach der Installation erscheint das Plugin in der "Installiert"-Liste. Schalte es per Toggle ein. Ggf. Neustart des Nodes erforderlich.

Manuell installieren

Community-Plugins können auch direkt aus einem GitHub-Repository installiert werden:

# Methode 1: Über das Dashboard
# Plugin-Manager → Marketplace → "Von URL installieren"
# URL: https://github.com/benutzer/hivemind-plugin-xyz

# Methode 2: Manuell
# 1. Plugin-Ordner herunterladen/klonen
git clone https://github.com/benutzer/hivemind-plugin-xyz \
  marketplace-plugins/plugin-xyz

# 2. Abhängigkeiten installieren (falls vorhanden)
cd marketplace-plugins/plugin-xyz
pip install -r requirements.txt

# 3. In config.yaml eintragen:
plugins:
  enabled:
    - web_search
    - calculator
    - plugin-xyz   # <-- neu

# 4. HiveMind neu starten

Plugin konfigurieren

Die meisten Plugins haben konfigurierbare Einstellungen. Diese können im Dashboard oder in der config.yaml gesetzt werden:

plugins:
  web_search:
    engine: "duckduckgo"       # oder "google" (API-Key erforderlich)
    max_results: 5
    safe_search: true

  image_gen:
    model: "sdxl-turbo"
    steps: 4
    resolution: "1024x1024"

Eigenes Plugin schreiben

Die Plugin-API ist einfach gehalten. Ein minimales Plugin:

from hivemind.plugins.base import Plugin, capability

class WeatherPlugin(Plugin):
    name = "weather"
    version = "1.0.0"
    description = "Ruft aktuelle Wetterdaten ab."

    @capability("Aktuelles Wetter abrufen")
    async def get_weather(self, city: str) -> str:
        """Gibt das aktuelle Wetter für eine Stadt zurück."""
        # Implementierung...
        return f"In {city} sind es 18°C und sonnig."

Speichere die Datei als marketplace-plugins/mein-plugin/plugin.py und trage den Plugin-Namen in die config.yaml ein.

Plugin deinstallieren

1. Plugin im Dashboard deaktivieren (Toggle aus)
2. Plugin aus config.yaml → plugins.enabled entfernen
3. Optional: Plugin-Ordner aus marketplace-plugins/ löschen
4. HiveMind neu starten