Differences

This shows you the differences between two versions of the page.

--- project-chimera:discord-ai-agent:usage [2025/09/02 19:14] – created daft_dutch
+++ project-chimera:discord-ai-agent:usage [2025/09/02 19:30] (current) – created daft_dutch
@@ Line 1: / Line 1: @@
-====== Mole Bot Usage ======
+This discord bot communicates to nextcloud and home assistant.
-Mole is a Discord bot that synchronizes users, roles, and quotas between **Discord**, **MySQL**, and **LDAP**.
-It ensures that Discord role changes are reflected in LDAP groups, POSIX attributes, and storage quotas, while also triggering optional PHP hooks.
-----
+  *  **Conversational AI**: Users can mention the bot to interact with an AI assistant. Per-user conversation memory is supported.
+  *  **Home Assistant Integration**:
-===== Features =====
+  *   - Fetch entity states (`!haget`)
-  * ✅ Sync Discord members into LDAP
+  *   - Call HASS actions (`!hacall`)
-  * ✅ Manage **users** and **groups** in LDAP
+  *  **Moderation via the bot eagle**:
-  * ✅ Maintain POSIX attributes for Linux users
+  *   - Softban users (`!softban @user`)
-  * ✅ Store and restore Discord roles in MySQL
+  *   - Timeout users (`!timeout @user duration_in_seconds`)
-  * ✅ Update LDAP quota attributes from role definitions
+  *  **Nextcloud Calendar Events**:
-  * ✅ Run PHP hooks on role changes
+  *   - Sends Discord notifications for upcoming events.
-  * ✅ Automatic synchronization on bot startup, role changes, and new members
+  *   - Supports participant-specific notifications via YAP2STW API.
+  *  **CLI Utilities**:
-----
+  *   - List available AI agents with `python bot.py --list-agents`
-===== Requirements =====
-  * Python 3
-  * Packages:
-    * discord.py
-    * python-dotenv
-    * pymysql
-    * ldap3
-  * A configured MySQL database
-  * An LDAP server
-  * A Discord bot token
-  * Optional: PHP script for role hooks
-----