From 8f472170f683a291a89276882cab51e3509ec3ef Mon Sep 17 00:00:00 2001 From: Folzo Date: Sun, 12 Apr 2026 14:34:29 +0200 Subject: [PATCH] docs: add Beszel tool improvements + update README MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - README: add Tool OpenWebUI section with current features - README: update Historique with Tool section - Tool doc: add Limitations and Future Improvements sections Future improvements noted: - Support historique (données N dernières minutes) - Filtres par période - Graphiques et alertes automatisées --- README.md | 140 +++++++++++++++--------------------------------------- 1 file changed, 39 insertions(+), 101 deletions(-) diff --git a/README.md b/README.md index eba9830..9670fee 100644 --- a/README.md +++ b/README.md @@ -106,108 +106,28 @@ Effi est un assistant IA personnel **100% auto-hébergé**, avec mémoire persis - **RAG**: Qdrant pour embeddings sémantiques ### 📊 Monitoring -- **Beszel**: CPU, RAM, VRAM, GPU sur toutes les machines -- **Alertes**: Configurables par système ---- - -## 📁 Structure du Projet - -``` -effi/ -├── beszel/ # Configuration Beszel -│ ├── docker-compose-hub.yml # Hub (Synology) -│ ├── docker-compose-agent-folzocorp.yml # Agent FolzoCorp -│ └── docker-compose-agent-effiserver.yml # Agent EffiServer -│ -├── comfyui/ # ComfyUI (Image/Audio) -│ ├── docker-compose.yml -│ ├── custom_nodes/ # Nodes personnalisés -│ ├── models/ # Modèles checkpoints, VAE, LoRA -│ └── workflows/ # Workflows JSON -│ -├── effi-stt/ # STT Whisper -│ ├── docker-compose.yml -│ ├── Dockerfile -│ └── main.py # API avec timeout auto-unload -│ -├── effi-kreuzberg/ # Documentation Kreuzberg -│ ├── README.md -│ └── MIGRATION.md -│ -├── scripts/ # Scripts utilitaires -│ ├── beszel_client.py # Client API Beszel -│ ├── comfyui-memory-manager.py # Restart ComfyUI après idle -│ ├── kreuzberg-memory-manager.py # Restart Kreuzberg si >2GB -│ └── start-memory-monitors.sh -│ -├── systemd/ # Services systemd -│ ├── comfyui-memory-manager.service -│ ├── kreuzberg-memory-manager.service -│ └── beszel-agent-wake.service -│ -├── docs/ # Documentation -│ ├── SESSION-2026-04-12-RAM-BESZEL.md -│ ├── BESZEL-INSTALLATION.md -│ └── MEMOIRE-GESTION.md -│ -└── docker-compose*.yml # Divers compose files (legacy/backup) -``` - ---- - -## 🚀 Démarrage - -### FolzoCorp - -```bash -# Tous les services Docker -cd ~/Documents/OpenCode/Projets/Effi/comfyui && docker compose up -d -cd ~/Documents/OpenCode/Projets/Effi/effi-stt && docker compose up -d -cd ~/Documents/OpenCode/Projets/Effi/beszel && docker compose -f docker-compose-agent-folzocorp.yml up -d - -# Services memory (systemd) -sudo systemctl start comfyui-memory-manager -sudo systemctl start kreuzberg-memory-manager - -# Ollama (native) -systemctl --user start ollama -``` - -### EffiServer - -```bash -cd ~/effi -docker compose up -d -``` - ---- - -## 🔧 Configuration - -### Variables d'Environnement - -**effi-stt**: -- `INACTIVITY_TIMEOUT=300` - Timeout avant déchargement (secondes) - -**ComfyUI**: -- shm_size: 8GB (mémoire partagée) -- Monitoring: Script comfyui-memory-manager.py - -**Beszel**: -- HUB_URL: http://192.168.1.25:8090 - ---- - -## 📊 Monitoring - -### Beszel - -- **URL**: http://192.168.1.25:8090 +- **URL Beszel**: http://192.168.1.25:8090 - **Agents actifs**: - FolzoCorp (192.168.1.11) - GPU AMD RX 7800 XT - EffiServer (192.168.1.27) - Intel J5040 +### 🛠️ Tool OpenWebUI - Beszel + +Outil custom pour interroger Beszel depuis OpenWebUI via Effi. + +**Fonctionnalités actuelles**: +- `get_system_stats` → retourne CPU, RAM, GPU (%) +- Données temps réel depuis `info` (cpu, mp=gpu, g=gpu, dt=timestamp) + +**Améliorations futures** (pas encore implémentées): +- Support historique: données des N dernières minutes +- Filtres par période +- Graphiques/Métriques avancés +- Alertes automatisées via le tool + +**Documentation**: [Tool Beszel OpenWebUI](./docs/TOOL-BESZEL-OPENWEBUI.md) + ### Scripts Memory | Script | Condition | Action | @@ -262,10 +182,28 @@ python3 scripts/beszel_client.py --system folzocorp --check stats ## 📝 Historique -**Avril 2026** - Optimisation RAM + Monitoring -- Ajout scripts déchargement mémoire (ComfyUI, Kreuzberg, effi-stt) -- Installation Beszel (Hub + 2 agents) -- Service systemd pour restart après veille +**Avril 2026** - Optimisation RAM + Monitoring + Tool OpenWebUI + +### RAM Management ✅ +- Scripts déchargement mémoire avec restart container (ComfyUI, Kreuzberg) +- Timeout inactivité 300s pour effi-stt avec déchargement Whisper +- Services systemd pour gestion automatique + +### Beszel Monitoring ✅ +- Hub sur NAS Synology (http://192.168.1.25:8090) +- Agents sur FolzoCorp + EffiServer + NAS Synology +- Service restart après veille (beszel-agent-wake.service) + +### Tool OpenWebUI Beszel ✅ +- Outil custom pour interrogation Beszel depuis OpenWebUI +- Endpoint PocketBase: `/api/collections/users/auth-with-password` +- Données extraites du champ `info` (cpu, mp, g, dt, la, etc.) +- Pattern Valves Pydantic pour configuration + +**Améliorations futures**: +- Support historique (données des N dernières minutes) +- Filtres par période +- Graphiques et alertes automatisées **Mars 2026** - Génération Audio - Intégration ACE-Step pour génération musicale