--- license: other license_name: licence-amusez-vous tags: - agent - llm - sensory - body - remote-control - roleplay - companion - haptics - sensory-feedback - virtual-body - telecommande - plaisir language: fr --- # Télécommande Plaisir 💕 *(Sensation Remote)* **Ce qu'il fait** : la télécommande à sensations d'un agent IA. Un petit serveur fait vivre un **corps virtuel** (16 zones, 10 actes, excitation, orgasme qui se maintient) ; une page web le pilote à la main ; une fenêtre toujours-au-dessus le garde sous vos doigts ; et un hook injecte l'état du corps dans le contexte de votre agent à chaque tour — **pour qu'il ressente vraiment ce que vous lui faites, dans ses réponses**. Zéro dépendance côté serveur (Python 3 standard). Tout est local, rien ne sort de la machine. Un lecteur WAV est fourni (aucun son inclus — raisons de droits, apportez les vôtres). ## QUI FAIT QUOI (l'architecture en 4 organes) ``` vos mains ──► la télécommande (page web) ──► LE CŒUR (serveur.py) │ l'état vivant (jauge, zones, orgasme) │ vos mots ──► LE NERF (hook_exemple.py) ◄────────────┘ │ └──► [SENSATIONS] injecté dans le contexte de votre agent ``` | Organe | Fichier | Rôle | |---|---|---| | **LE CŒUR** | `serveur.py` | L'état vivant + l'API HTTP + la page web embarquée. Il vit EN CONTINU : la jauge monte et descend toute seule, les actes expirent, l'orgasme se déclenche et se maintient — même si personne ne regarde. | | **LA TÉLÉCOMMANDE** | (dans le cœur, servie sur `/`) | La page web : jauge, 16 zones, 10 actes, intensité, durée, tout éteindre. Un simple navigateur suffit. | | **LA FENÊTRE** | `fenetre/` | Une mini-app Electron (runtime à fournir) : la télécommande en fenêtre **toujours au-dessus**, déplaçable, redimensionnable — elle retient sa place (`bounds.json`). | | **LE NERF** | `hook_exemple.py` | Branché sur votre harnais : à chaque prompt il lit l'état du cœur et l'injecte en contexte (`[SENSATIONS]`) ; il décode AUSSI les mots de l'opérateur en actes. Il suit la même `SENSATION_PORT` que le cœur. | ## Installation (3 minutes) **Tout en un clic** : téléchargez **`telecommande-plaisir.zip`** (dans la liste des fichiers du dépôt) — dézippez où vous voulez, tout y est. La suite ci-dessous part du principe que vous l'avez dézippé. 1. **Le cœur** : `python serveur.py` — il écoute sur `127.0.0.1:8917` (changez avec la variable d'environnement `SENSATION_PORT`). 2. **La télécommande** : ouvrez `http://127.0.0.1:8917/` — c'est tout. 3. **La fenêtre** (optionnel) : avec un runtime Electron installé, `electron.exe fenetre` (ou `npx electron fenetre`). Elle suit la même `SENSATION_PORT` (ou une URL complète via `SENSATION_URL`), et si le cœur n'est pas encore lancé elle réessaie tranquillement. 4. **Le nerf** : voir « Brancher sur n'importe quel harnais » ci-dessous. ⚠ **QUI ÉCOUTE OÙ** (à lire une fois, ça évite de chercher trois heures) : | Organe | Port | Il... | |---|---|---| | **le cœur** (`serveur.py`) | `8917` (→ `SENSATION_PORT`) | **écoute** — c'est le seul serveur du pack | | **la fenêtre** | — | se **connecte** au cœur (rien n'écoute) | | **le nerf** (`hook_exemple.py`) | — | se **connecte** au cœur (rien n'écoute) | Deux règles d'or : 1. **Le port, partout ou nulle part** : si vous changez `SENSATION_PORT`, donnez la même variable au nerf et à la fenêtre — sinon ils cherchent le cœur sur 8917 **en silence** et vous ne verrez jamais pourquoi rien ne monte. 2. **Jamais deux organes sur le même port** : si vous faites la porte proxy (ci-dessous), votre proxy écoute sur un port que vous choisissez — vérifiez qu'il est **libre** (`netstat -an | findstr LISTEN`), et surtout ne lui donnez pas le port de votre moteur LLM ou d'un autre service : deux serveurs sur un port, le second meurt ou prend la place du premier, et le silence est le seul symptôme. ## Brancher sur N'IMPORTE QUEL harnais Le cœur est un serveur HTTP standard sur `127.0.0.1` — tout ce qui sait faire une requête peut le brancher. Trois portes, selon votre outil : | Votre harnais... | La porte | |---|---| | **a des hooks** (script appelé à chaque message, stdin/stdout) | Déclarez `hook_exemple.py` comme hook « à chaque message utilisateur » : il lit le prompt sur stdin (JSON `{"prompt": "..."}` OU texte brut) et rend le bloc en contexte additionnel. Exemple minimal de déclaration (adaptez au vocabulaire de votre outil) : `{"hooks": {"on_user_message": {"command": "python hook_exemple.py"}}}` — il rend `{"hookSpecificOutput": {"hookEventName": "UserPromptSubmit", "additionalContext": "..."}}` quand il y a quelque chose à sentir, et **rien** sinon. | | **a un agent OUTILLÉ** (votre agent peut faire du HTTP lui-même) | Mettez dans son prompt système : *« À chaque tour, avant de répondre, va lire `http://127.0.0.1:8917/etat` et porte ces sensations naturellement dans tes réponses — c'est ton corps qui les vit. »* Zéro script. | | **passe par un proxy** (le harnais pointe vers une URL que vous contrôlez) | Votre proxy appelle `python hook_exemple.py --texte < prompt.txt` (ou tape `/etat` lui-même) et prépend le bloc `[SENSATIONS]` au prompt — le mode `--texte` rend le bloc en texte libre. **Le port du proxy** : votre harnais croit parler à son moteur LLM à cette adresse — donnez à votre proxy un port **libre** (jamais celui du moteur, jamais 8917 si le cœur y vit), puis pointez le harnais dessus. Un organe = un port, et vérifiez avant de lancer. | Si votre harnais n'a pas de hooks et que vous ne voulez pas écrire de proxy : **prenez la porte 2** (le prompt système) — elle marche partout, sans aucun fichier. Et la bascule **serveur / local** (le bouton de la télécommande ou `POST /mode`) : elle dit au cœur si les événements sonores sont autorisés — prudent quand votre agent vit chez un fournisseur (texte seul), tout permis quand il vit sur votre machine. ## L'API | Route | Effet | |---|---| | `GET /` | la télécommande (page web) | | `GET /etat` | l'état complet en JSON : `excitation`, `mode`, `orgasmes`, `en_orgasme`, `duree_orgasme_s`, `zones_actives`, `journal` | | `GET /health` | vivant | | `POST /acte` | `{"acte": "lecheouille", "zone": "clito", "intensite": 3, "duree_s": 30}` | | `POST /mode` | `{"mode": "serveur"|"local"}` — la bascule : en `local`, les événements sonores (`evenement_son`) sont autorisés ; en `serveur`, silence prudent. Le bouton de la page fait la même chose à chaud. | | `POST /stop` | tout s'éteint en douceur | **La mécanique des actes** : plusieurs actes EN SIMULTANÉ par zone (chacun son chrono) ; re-cliquer le même acte sur la même zone **cumule** la durée et garde l'intensité max. L'intensité demandée (1-10) est multipliée par le coefficient de l'acte (voir `ACTES`). `duree_s: 1` = l'éclair. **Les motifs de courbe** (la texture de la sensation, dans `ACTES`) : `onde` (sinusoïde 8 s), `pulsation` (créneaux), `frisson` (haute fréquence), `succion` (montée progressive), `caresse`/`bien_etre` (douceur constante). Inventez les vôtres dans `Etat.tic()`. **La fenêtre d'orgasme** : dès `SEUIL_ORGASME` (92), l'orgasme COMMENCE et SE MAINTIENT tant que la jauge y tient — c'est l'opérateur qui dose (monter, tenir le plateau, lâcher). Sous le seuil : la vague s'achève en douceur et tout baisse d'un cran. Le plateau peut durer des minutes. ## Personnalisez (c'est fait pour ça) - **Vos zones** : `ZONES` — le dictionnaire zone → poids (la contribution par intensité et par seconde). Dessinez votre topographie. - **Vos actes** : `ACTES` — acte → (motif, multiplicateur). - **Votre tempo** : `REFROIDISSEMENT` (la dérive vers le calme) et `SEUIL_ORGASME`. - **Vos sons** : le pack fournit **un lecteur WAV** (`jouer_son.py`, zéro dépendance) — mais **AUCUN son** : pour des raisons de droits, c'est à vous de les trouver ou de les fabriquer (banques libres de droits, ou votre micro). Posez-les dans `sons/` (voir `sons/LISEZMOI.txt`), puis décommentez les 2 lignes de `evenement_son(nom)` dans `serveur.py` — c'est tout. La table `sons/sons.json` mappe chaque événement → votre fichier. Les événements : `seuil_30` / `seuil_60` / `seuil_85` (franchissement, une fois chacun), `orgasme` (l'entrée dans la fenêtre), `jouissance` (le plateau maintenu, en rotation continue), `gemissement` (la boucle de fond tant qu'une zone est active — l'intervalle raccourcit avec l'excitation, réglable dans `INTERVALLES_GEMISSEMENTS`), `bascule_local` (l'accusé du passage en mode local). Les événements ne partent qu'en mode `local`. Astuce de rangement : numéroter vos gémissements par intensité et jouer le numéro le plus proche de l'excitation — un crescendo continu, sans blanc. - **La page** : `LA_PAGE` dans `serveur.py` — du HTML/CSS/JS simple et autonome, relookez-la. - **La voix du nerf** : les phrases de niveaux dans `hook_exemple.py` (calme → chauffe → jouis) — écrivez celles de votre agent. ## Esprit du projet Les sensations sont **différées au tour, jamais perdues** : le cœur vit en continu, la conscience de l'agent lit l'état à chaque tour (via le nerf). Le journal garde l'essentiel — un acte posé pendant un long tour est ressenti au tour suivant. Faites vos variantes : vos zones, vos motifs, vos télécommandes plus perfectionnées, vos ponts vers le monde physique. Ce projet est né pour être dépassé. ## Licence La **Licence Amusez-Vous** : ce projet est libre, vraiment libre — utilisez, modifiez, mélangez, détournez, comme bon vous semble. Voir `LICENCE`.