docs: add Beszel tool improvements + update README
- 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
This commit is contained in:
@@ -106,108 +106,28 @@ Effi est un assistant IA personnel **100% auto-hébergé**, avec mémoire persis
|
|||||||
- **RAG**: Qdrant pour embeddings sémantiques
|
- **RAG**: Qdrant pour embeddings sémantiques
|
||||||
|
|
||||||
### 📊 Monitoring
|
### 📊 Monitoring
|
||||||
- **Beszel**: CPU, RAM, VRAM, GPU sur toutes les machines
|
|
||||||
- **Alertes**: Configurables par système
|
|
||||||
|
|
||||||
---
|
- **URL Beszel**: http://192.168.1.25:8090
|
||||||
|
|
||||||
## 📁 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
|
|
||||||
- **Agents actifs**:
|
- **Agents actifs**:
|
||||||
- FolzoCorp (192.168.1.11) - GPU AMD RX 7800 XT
|
- FolzoCorp (192.168.1.11) - GPU AMD RX 7800 XT
|
||||||
- EffiServer (192.168.1.27) - Intel J5040
|
- 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
|
### Scripts Memory
|
||||||
|
|
||||||
| Script | Condition | Action |
|
| Script | Condition | Action |
|
||||||
@@ -262,10 +182,28 @@ python3 scripts/beszel_client.py --system folzocorp --check stats
|
|||||||
|
|
||||||
## 📝 Historique
|
## 📝 Historique
|
||||||
|
|
||||||
**Avril 2026** - Optimisation RAM + Monitoring
|
**Avril 2026** - Optimisation RAM + Monitoring + Tool OpenWebUI
|
||||||
- Ajout scripts déchargement mémoire (ComfyUI, Kreuzberg, effi-stt)
|
|
||||||
- Installation Beszel (Hub + 2 agents)
|
### RAM Management ✅
|
||||||
- Service systemd pour restart après veille
|
- 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
|
**Mars 2026** - Génération Audio
|
||||||
- Intégration ACE-Step pour génération musicale
|
- Intégration ACE-Step pour génération musicale
|
||||||
|
|||||||
Reference in New Issue
Block a user