# doc-project | remote-agent/windows/README.txt | Instructions Windows avec WebRTC P2P, repli HTTP, auto-mise-a-jour et reprise

REMOTE AGENT TEMPORAIRE - WINDOWS

1. Decompressez entierement l'archive ZIP dans un dossier de votre choix.
2. Verifiez que Python 3 est installe sur l'ordinateur.
3. Double-cliquez sur start.bat.
4. Le lanceur verifie automatiquement si une revision plus recente du package est disponible, la telecharge et verifie son SHA-256 avant installation.
5. Si le serveur de mise a jour est temporairement indisponible, la derniere version locale valide est lancee sans bloquer la session.
6. Le client valide ensuite la capture et l'injection d'entree avant de reprendre ou creer la session.
7. Le terminal affiche une URL de session unique, reutilisee apres un redemarrage recuperable tant que la session reste valide.
8. Cette URL est automatiquement copiee dans le presse-papiers; transmettez-la uniquement au service ou a l'agent IA que vous autorisez.
9. Si la copie automatique echoue, copiez manuellement l'URL qui reste affichee dans le terminal.
10. Le meme lien peut etre ouvert dans plusieurs navigateurs; un seul detient le bail de controle, les autres restent en lecture seule.
11. Fermez la fenetre ou utilisez Ctrl+C pour revoquer immediatement la session.

Le coeur du client utilise la bibliotheque standard Python et les API Windows normales; WebRTC utilise une dependance Python locale optionnelle. La capture GDI s'execute
dans un processus worker distinct afin qu'un crash natif ne coupe pas directement la session reseau. Le worker peut
etre recree avec un backoff limite, puis l'agent force une nouvelle frame complete. Il capture le bureau virtuel,
y compris plusieurs ecrans, et adapte l'image avant transmission. Le controle ne tente pas
de contourner UAC, le Secure Desktop, l'ecran de connexion ni les autres protections Windows.

Aucune installation au demarrage de Windows n'est creee. Un arret volontaire revoque le lien. En cas de crash
recuperable ou de coupure reseau, les identifiants locaux permettent de reprendre la meme session tant que son TTL glissant reste valide.


Depuis la version 1.4.0, le client tente en priorite une liaison WebRTC P2P directe avec le navigateur. Les dependances
WebRTC sont installees localement dans le dossier du client via pip, sans droits administrateur et sans modifier Python
systeme. Si pip, Internet, STUN/TURN ou la negociation P2P sont indisponibles, la session continue automatiquement
avec le relais HTTP historique. Les commandes P2P restent limitees au controleur possedant le bail exclusif du serveur.

Le protocole expose uniquement la capture d'ecran et des operations souris/clavier definies. Il ne permet
pas l'execution arbitraire de commandes distantes.

Le fichier start.bat sert de bootstrap stable. Les mises a jour remplacent atomiquement les fichiers du client
quand cela est possible, conservent les fichiers locaux absents du package et utilisent un verrou pour eviter
deux mises a jour concurrentes. Si l'agent principal subit un arret fatal reconnu, le bootstrap effectue une unique
relance de secours afin d'eviter une boucle infinie.