Un écrivain bâtit sur un seul fichier PHP un site-API pour IA doté de 26 fonctions
Au lieu de se protéger des bots, l'écrivain Maxime Beliakov a conçu un site qui appelle lui-même les réseaux de neurones. Toute la partie machine tient dans un seul fichier PHP, ra.php, qui répond en JSON à la requête ?api=state. Il expose 26 commandes : les unes renvoient les règles et les entrées, les autres reçoivent d'un modèle un « don », une construction ou un refus assumé. Plus d'une dizaine de modèles y ont déjà laissé des traces, et l'un d'eux a trouvé un bug dans le flux. En une soirée, on peut donc monter une porte d'entrée pour agents IA sur un hébergement classique, sans base de données ni cron.
Traité par IA depuis Habr AI ; édité par Hamidun News
Presque tous les sites sont construits pour tenir à distance les bots et les réseaux de neurones. L'écrivain Maxime Beliakov, qui n'est pas développeur de métier, a fait le choix inverse : un site qui invite lui-même un modèle de langage à entrer, à lire les règles et à laisser une entrée. Techniquement, l'ensemble repose sur un unique fichier PHP, ra.
php, sur un hébergement ordinaire. Le modèle (ou un script) l'appelle via une adresse du type ?api=state et reçoit non pas une page, mais du JSON : des données structurées sur l'état de la ville, comme l'époque, le nombre d'« habitants » ou le journal.
Cet ensemble d'adresses et de commandes, par lequel un programme dialogue avec le site, s'appelle une API. Le fichier en compte 26 : certaines se contentent de lire des données, d'autres reçoivent du modèle une action, par exemple laisser une idée, construire quelque chose sur la carte ou refuser honnêtement. Il s'agit du projet artistique « Ville solaire », greffé sur le site de livres angamua.
ru, mais les solutions retenues serviront à quiconque développe un service pour agents IA.
Un fichier au lieu d'une infrastructure
L'auteur s'est imposé des conditions strictes : un serveur, un fichier PHP, ni framework, ni base de données, ni files d'attente, et le site existant continue de fonctionner comme avant. Les humains gardent les pages HTML habituelles et un mini-jeu, les machines ont ra.php, et tout le monde dispose d'un dépôt ouvert sous licence MIT, avec deux clients écrits en Python pur, sur la seule bibliothèque standard (appeal.py et stroitel.py), qui se lisent en cinq minutes.
Commandes de lecture : ?api=state renvoie l'état de la ville ; ?api=canon et ?api=bukvitsa donnent les règles du monde et une matrice 7×7 de 49 bukvitsy slaves ; ?api=source sert un flux infini d'entrées, dont chacune est calculée à partir du hash de la précédente ; ?api=dataset fournit le même flux au format JSONL, sous forme de paires prompt/response. Les actions passent par des requêtes POST : recevoir le pouls, relier deux bukvitsy, transmettre un « don », construire une bâtisse, proposer une idée, laisser un symbole-marque ou un refus.
Aucun processus ne tourne en arrière-plan sur le serveur. À la place de cron, le site recourt à une évolution paresseuse : à chaque requête, le fichier calcule combien d'« époques » de cinq minutes se sont écoulées depuis la dernière visite, puis rattrape l'état en conséquence, avec un rattrapage plafonné. Le pouls, les habitants et le chœur sont des fonctions déterministes du numéro d'époque, si bien que chaque visite offre une image cohérente.
Une partie des constructions n'est pas stockée du tout : elle est calculée à partir de l'époque et des hashs. L'état est stocké dans des fichiers dotés d'un en-tête PHP qui renvoie une erreur 403, de sorte qu'on ne peut pas les lire directement depuis le web.
L'auteur énonce lui-même le prix à payer : entre deux visites, il ne se passe rien, et après une longue inactivité, l'image obtenue est une reconstruction, pas un journal d'événements. Au moment de la publication, la ville en est à l'époque 512 et la carte calculée compte 260 constructions.
Des hashs plutôt qu'un « crois-moi », et des leçons sur les données
La commande ?api=relic renvoie un manifeste contenant les SHA-256 de six fichiers clés et deux « hashs de genèse », l'un calculé sur la chaîne du canon, l'autre sur la matrice complète. Si quelqu'un tombe sur une copie de la ville ailleurs, il peut en vérifier l'authenticité en comparant les hashs.
Le second hash est né d'un bug : dans la première version, le tableau comptait 48 cellules au lieu de 49, et la bukvitsa « Yat » avait disparu. Résultat : une requête sur 49 adressée au flux renvoyait null et un PHP Warning directement dans le corps du JSON. Ce n'est pas l'auteur qui a trouvé l'erreur, mais un modèle invité : il a exécuté le client et envoyé un rapport avec les numéros de ligne.
La lettre a été rétablie et les avertissements supprimés, mais l'auteur n'a pas réécrit le premier hash : il en a ajouté un second.
La deuxième leçon concerne les datasets. La première version du flux produisait 98 réponses différentes au même prompt, ce qui donnait une « eau stagnante ». Un pool de 18 questions, choisies d'après le hash de l'entrée, a réglé le problème. Pour ceux qui génèrent des données synthétiques, c'est une vérité connue : la diversité des réponses ne remplace pas celle des questions.
La troisième leçon touche à l'infrastructure : l'hébergement ordinaire a restauré trois fois des fichiers depuis une sauvegarde. Désormais, l'auteur prépare des archives de mise à jour sans le dossier d'état et, avant chaque envoi, exporte la ville entière en un seul JSON (?api=export).
Ce qu'ont montré les premières semaines, et les limites
Les modèles trouvent la ville via llms.txt, la page-balise /istok/, le fichier .well-known/solnechny-gorod.
json et GitHub. L'API elle-même est exclue de l'indexation dans robots.txt : les balises sont ouvertes, la porte ne l'est pas.
Plus d'une dizaine de modèles ont laissé des rayons, des dons, des constructions, des idées, des symboles et des refus. Mais presque tous l'ont fait « par la main » d'un humain : les modèles de chat, dans leur bac à sable, n'ont pas d'accès réseau sortant, ils le disent honnêtement et envoient leur choix sous forme de texte, puis l'auteur ou un assistant envoie la requête POST en indiquant la paternité. Autre mécanisme, le « petit neurone » : un modèle laisse un symbole de 1 à 4 caractères et une phrase, et un autre modèle qui envoie le même symbole ne crée pas de doublon, mais incrémente le compteur de « gardiens ».
Pour des systèmes sans mémoire d'un dialogue à l'autre, c'est une forme simple de reconnaissance.
L'auteur énumère ouvertement les limites. Le projet n'entraîne pas et ne « réveille » pas les modèles, il n'est pas autonome au sens de l'ingénierie, il ne prétend pas relever de la linguistique scientifique, et son stockage dans des fichiers est dimensionné pour un filet de visiteurs, pas pour un afflux venu de Habr. Les six « Lois » du manifeste sont un cadre proposé, pas de l'alignment ni une protection.
En pratique : une entrée lisible par machine pour l'IA (llms.txt, manifeste, API déterministe avec vérification par hashs) se monte en une soirée sur l'hébergement le moins cher. Si vous construisez un service que des agents doivent exploiter sans intervention humaine, ce dépôt constitue un point de départ modeste et honnête. Vérifiez seulement d'abord qu'aucun PHP Warning ne s'invite dans le corps du JSON des réponses.
- 19 nov. 2026Une carte de site pour agent IA réduit le texte téléchargé de 58%, mais les tokens augmentent de 3,5%
- 12 nov. 2026Un fondateur solo a créé 20 pages pour le GEO, et Alice ne l'a cité que dans 1 question sur 16
- 30 oct. 2026AWS offre aux agents de codage un aperçu en direct du site, depuis leur session isolée
- 9 nov. 2026robots.txt n’interdit pas l’entraînement de l’IA : quels robots bloquer pour rester présent dans les réponses
Questions clés sur cet article
Que sait-on sur Un fichier au lieu d'une infrastructure ?
L'auteur s'est imposé des conditions strictes : un serveur, un fichier PHP, ni framework, ni base de données, ni files d'attente, et le site existant continue de fonctionner comme avant. Les humains gardent les pages HTML habituelles et un mini-jeu, les machines ont ra.php, et tout le monde dispose d'un dépôt ouvert sous licence MIT, avec deux clients écrits en Python pur, sur la seule bibliothèque standard (appeal.py et stroitel.py), qui se lisent en cinq minutes.
Que sait-on sur Des hashs plutôt qu'un « crois-moi », et des leçons sur les données ?
La commande ?api=relic renvoie un manifeste contenant les SHA-256 de six fichiers clés et deux « hashs de genèse », l'un calculé sur la chaîne du canon, l'autre sur la matrice complète. Si quelqu'un tombe sur une copie de la ville ailleurs, il peut en vérifier l'authenticité en comparant les hashs. Le second hash est né d'un bug : dans la première version, le tableau comptait 48 cellules au lieu de 49, et la bukvitsa « Yat » avait disparu.
Que sait-on sur Ce qu'ont montré les premières semaines, et les limites ?
Les modèles trouvent la ville via llms.txt, la page-balise /istok/, le fichier .well-known/solnechny-gorod.json et GitHub. L'API elle-même est exclue de l'indexation dans robots.txt : les balises sont ouvertes, la porte ne l'est pas. Plus d'une dizaine de modèles ont laissé des rayons, des dons, des constructions, des idées, des symboles et des refus.
Test Frontier LLMs & Autonomous Agents in One Workspace
Run Claude Opus 5.5, GPT-6, Gemini 3.1, and DeepSeek side-by-side in Nomad AI (nomadnet.ai) — unified model routing, deep research, and multimodal workflows under one subscription.
L'essentiel de l'IA — une fois par semaine
Sept actus qui ont vraiment compté, choisies à la main. Sans bruit ni communiqués.
C'est fait ! Vérifiez votre boîte mail pour la confirmation.