Files
Hermes_rocket.chat_Plugin/README.md
T

2.0 KiB

Hermes_rocket.chat_Plugin

Nützliches Add-on für Hermes Agent> um Rocket.Chat als Messaging-Plattform zu nutzen.

Stellt einen nativen Chatclient für das Hermes Agent Gateway bereit — mit Echtzeit-Nachrichten via WebSocket/DDP und REST-API für ausgehende Antworten.

Features

  • Echtzeit-Streaming: WebSocket/DDP für sofortige eingehende Nachrichten
  • Präsenz-Status: Grüner Online-Indikator im Rocket.Chat
  • Markdown-Support: Fett, kursiv, Inline-Code, Code-Blöcke, Links
  • Interaktive Buttons: Ja/Nein, Bestätigen/Abbrechen, Mehrfachauswahl
  • Raum-Unterstützung: Kanäle, private Gruppen, Direktnachrichten
  • Allowlist: Steuerung, wer den Bot nutzen darf

Installation

# In dein Hermes Agent Verzeichnis wechseln
cd ~/.hermes/hermes-agent

# Plugin-Verzeichnis anlegen
mkdir -p plugins/platforms/rocketchat

# Diese drei Dateien hineinkopieren:
cp plugin.yaml   plugins/platforms/rocketchat/
cp __init__.py   plugins/platforms/rocketchat/
cp adapter.py    plugins/platforms/rocketchat/

Konfiguration

Über Umgebungsvariablen

export ROCKETCHAT_BASE_URL="https://rocketchat.example.com"
export ROCKETCHAT_USER="bernd"
export ROCKETCHAT_PASSWORD="dein-passwort"
export ROCKETCHAT_ROOM_ID="J3jvMyrKTMzKvKHSh"      # optional
export ROCKETCHAT_ALLOWED_USERS="andreas,max"       # optional
export ROCKETCHAT_ALLOW_ALL_USERS="false"           # default

Über config.yaml

plugins:
  platforms:
    rocketchat:
      enabled: true
      base_url: "https://rocketchat.example.com"
      user: "bernd"
      password: "dein-passwort"
      room_id: "J3jvMyrKTMzKvKHSh"      # optional
      allowed_users: ["andreas", "max"] # optional
      allow_all_users: false            # default

Abhängigkeiten

Keine externen Pakete erforderlich — nutzt ausschließlich Python-Standardbibliothek (urllib, socket, ssl, threading).

Lizenz

Unlicense — Public Domain