Garde-mémoire GPU & système pour machines qui font tourner des LLM : surveillance RAM / VRAM / CPU en temps réel, sortie JSON agent-ready, suggestions correctives jamais appliquées d'office. Version 1.0 — 22/09/2026.
Problème : quand un modèle sature la VRAM, la machine se dégrade puis gèle. L'utilisateur voit l'effondrement, pas la montée.
Solution : VRAM Guard surveille en continu la VRAM, la RAM, le CPU et la décharge sur le SSD (swap), détecte l'offload (modèle partiellement déchargé en RAM/CPU), identifie le processus gourmand et propose l'action qui libère le plus de mémoire. Fenêtre discrète toujours au premier plan, zéro télémétrie.
Donner à un humain et à un agent autonome un état fiable et structuré de la machine, pour décider avant que le gel ne survienne. Quatre cibles de surveillance : usage GPU/VRAM (la plus critique), CPU, RAM, swap SSD.
Une suggestion est une information, pas une exécution : l'application d'une action reste explicite (--apply <pid>). Le produit est un garde-fou, pas un automatisme.
Le cœur vguard-cli est libre, gratuit et zéro dépendance sur Linux, Windows et macOS. Architecture Go modulaire :
| Paquet | Rôle |
|---|---|
/cmd | Points d'entrée : vguard-cli, vguard-gui |
/internal/sniff | Détection du modèle actif (Ollama, nvidia-smi best-effort) |
/internal/guard | Logique du garde-fou, seuils, suggestions correctives |
/internal/health | Mesures VRAM/RAM/CPU/températures |
/internal/out | Sortie JSON agent-ready / humain |
Double licence AGPL v3 + commerciale. Le cœur CLI est libre et gratuit ; l'application fenêtrée est soumise à la licence payante (10 jours d'essai).
GPU & system memory guard for machines running LLMs: real-time RAM / VRAM / CPU monitoring, agent-ready JSON output, corrective suggestions never applied by default. Version 1.0 — 22/09/2026.
Problem: when a model saturates VRAM, the machine degrades then freezes. The user sees the collapse, not the rise.
Solution: VRAM Guard continuously monitors VRAM, RAM, CPU and SSD swap, detects offloading (model partially offloaded to RAM/CPU), identifies the greedy process and proposes the action that frees the most memory. A discreet window always in the foreground, zero telemetry.
Give a human and an autonomous agent a reliable, structured state of the machine, to decide before the freeze occurs. Four monitoring targets: GPU/VRAM usage (most critical), CPU, RAM, SSD swap.
A suggestion is information, not execution: applying an action stays explicit (--apply <pid>). The product is a guardrail, not an automation.
The vguard-cli core is libre, free and zero-dependency on Linux, Windows and macOS. Modular Go architecture:
| Package | Role |
|---|---|
/cmd | Entry points: vguard-cli, vguard-gui |
/internal/sniff | Active model detection (Ollama, best-effort nvidia-smi) |
/internal/guard | Guardrail logic, thresholds, corrective suggestions |
/internal/health | VRAM/RAM/CPU/temperature measurements |
/internal/out | Agent-ready / human JSON output |
Dual license AGPL v3 + commercial. The CLI core is free and libre; the windowed application is subject to the paid license (10-day trial).