Version 1.0 — 22/09/2026 — Application publiée (v1.2.1). Livre blanc distinct des autres services du site.

Livre blanc — VRAM_GUARD Pro (garde-fou VRAM/RAM)

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.

Résumé en une page

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.

Statut transparent : v1.2.1 publiée. Le cœur vguard-cli est libre, gratuit et zéro dépendance sur Linux, Windows et macOS. La licence payante ne concerne que l'application fenêtrée (GUI) : 10 jours d'essai, lancements illimités, toutes fonctions, aucune limite artificielle. La GUI macOS reste à produire (build natif sur machine cible).

1. Pourquoi — Objectifs

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 sous charge d'inférence), 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.

2. Ce que le service ne promet PAS

Il n'agit pas à votre place : aucune action automatique, jamais. Il propose, vous (ou votre agent) décidez.
Il ne prédit pas la panne matérielle ; il mesure la charge réelle et les seuils franchis.
Il n'envoie aucune donnée à l'extérieur : pas de télémétrie, pas de compte, pas d'e-mail pour la licence.
La GUI macOS n'existe pas encore ; le cœur CLI, lui, fonctionne sur les trois OS.

3. La méthode — architecture Go modulaire

Paquet	Rôle
`/cmd`	Points d'entrée : `vguard-cli` (monitoring, `--query`/`--json`, daemon), `vguard-ui` (fenêtré), `vguard-daemon`.
`/internal/monitor`	Boucle de surveillance périodique avec contexte (`Monitor.Start`, `checkResources`) et moteur de décision à seuils.
`/internal/hardware`	Couche d'abstraction matérielle (HAL) : implémentations Linux, Windows, macOS.
`/internal/action`	Stratégies d'atténuation et application explicite d'une suggestion (`--apply <pid>`).
`/internal/license`	État local de licence (essai 10 jours, plans payants) ; vérification isolée, cœur sans réseau.
`/pkg/models`	Le contrat : `SystemStats` + `Resource`, structure universelle JSON vers les agents.

Mesures réelles, pas d'estimation : RAM via /proc/meminfo, charge CPU via /proc/loadavg, VRAM NVIDIA via nvidia-smi et AMD/Intel via sysfs DRM. La boucle tourne en continu ou en mode daemon (pid + journal daté, --daemon / --stop).

4. Le contrat JSON agent-ready

Le modèle SystemStats est le contrat d'échange avec les agents : un agent lit status et les métriques pour alléger sa charge avant un pic.

{
  "timestamp": "…",
  "status": "OK" | "WARNING" | "CRITICAL",
  "memory":       { "used_mb":…, "total_mb":…, "percentage":… },
  "video_memory": { "used_mb":…, "total_mb":…, "percentage":… },
  "cpu":          { "used_mb":…, "total_mb":…, "percentage":… }
}

Émission branchée : vguard-cli --query --json rend cette structure. Mesure du swap : --swap.

5. Licence & activation

Étape	Que se passe-t-il ?
1. Essai	10 jours, lancements illimités, toutes les fonctions. Ensuite l'application ne démarre plus sans clé.
2. Paiement	USDC sur Base (`eip155:8453`) vers `0xC0a88DD779583189FE2CFFf4aac5D5fE284AFeCc`, montant du plan choisi.
3. Activation	Dans l'application, par le formulaire du site, ou par l'API : `POST /api/v1/license/activate {plan, tx_hash, wallet}`.
4. Clé	Une clé `VG-…` est remise immédiatement : l'essai s'arrête, la licence est active.
5. Vérification	`GET /api/v1/license/verify?key=…` — `{license_key, plan, expires_at, updates}`.

Ce sont des licences à durée, pas des abonnements : aucun renouvellement automatique n'est possible on-chain. À l'échéance, c'est vous qui décidez de repayer — un rappel d'échéance est offert.

6. Tarifs

Plan	Prix	Équivalent
Essai	0	10 jours, lancements illimités
Premier mois	0,25 USDC	mois unique, non renouvelable (1 par wallet + machine)
3 mois	1,80 USDC	0,60 USDC / mois
6 mois	3,30 USDC	0,55 USDC / mois
9 mois	4,60 USDC	0,51 USDC / mois
12 mois	5,99 USDC	0,50 USDC / mois — mises à jour incluses
À vie	10 USDC	achat définitif, mises à jour incluses

Le cœur vguard-cli reste libre et gratuit : la licence ne s'applique qu'à l'application fenêtrée. Le cœur reste agent-ready et sans verrou — c'est un choix délibéré.

7. Transparence technique

Binaires publiés avec leurs empreintes (SHA256SUMS.txt, mis à jour à chaque version) : vguard-ui-linux-amd64 (31 Mo), vguard-ui-windows-amd64.exe (49 Mo), vguard-cli-linux-amd64 (9,3 Mo), vguard-cli-windows-amd64.exe (3,6 Mo), vguard-cli-darwin-amd64 (3,5 Mo). Vérification : sha256sum -c SHA256SUMS.txt (Linux/macOS), Get-FileHash … -Algorithm SHA256 ou certutil -hashfile … SHA256 (Windows).

Le binaire Windows n'est pas signé par un certificat de signature de code : Windows SmartScreen affiche donc un avertissement à l'ouverture. C'est attendu pour un éditeur indépendant. Débloquez le fichier (clic droit → Propriétés → Débloquer), vérifiez l'empreinte SHA256, puis exécutez. Le certificat coûte chaque année l'équivalent de plusieurs dizaines de licences annuelles ; pour une application à 5,99 USDC, l'arithmétique est cruelle — dit franchement plutôt que gonflée dans le prix. La signature viendra quand les téléchargements la payeront.

8. Limites

Pas de GUI macOS à ce jour (le CLI fonctionne) ; pas de signature de code Windows (SmartScreen avertit).
Les suggestions sont des propositions : rien n'est appliqué sans --apply.
Les seuils sont des seuils, pas des diagnostics : un CRITICAL signale une pression, pas une cause.
Les métriques dépendent du matériel exposé par le système (nvidia-smi, sysfs DRM, /proc) : pas de pilote propriétaire exotique, pas de mesure.

9. Essayer

# Cœur CLI (libre, zéro dépendance)
vguard-cli --query --json          # état structuré, agent-ready
vguard-cli --swap                  # mesure du swap
vguard-cli --daemon                # surveillance continue (pid + journal)
vguard-cli --stop
vguard-cli --apply <pid>           # applique explicitement la suggestion

# GUI (essai 10 jours, lancements illimités)
vguard-ui-linux-amd64  ·  vguard-ui-windows-amd64.exe

# Licence
POST /api/v1/license/activate {plan, tx_hash, wallet} → clé VG-…

10. Roadmap

Livré : Sprints 1 à 3 (cœur + HAL Linux, intégration VRAM/GPU, interface agent JSON, mode daemon, suggestions correctives, GUI Linux). À venir : GUI macOS (build natif sur machine cible), poursuite de l'approfondissement de la vision produit (GPU/VRAM, CPU, RAM, swap) et de la qualité des suggestions.

Document rédigé le 22/09/2026 — livre blanc distinct des autres services du site. Aucune promesse de token ni de revenu.