ponpon76's picture
README : tout-en-un par le zip + le zip telecommande-plaisir.zip
e2d19c7 verified
|
Raw History Blame Contribute Delete
9.96 kB
metadata
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"
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.