Aller au contenu
Votre IA@https://hoody.com Connect to Hoody

Mode dev

Sans fioritures. Voici Hoody, concrètement.

Chaque section affiche maintenant les appels exacts de l’API Bot qui la font fonctionner, avec le bouton Copier. La liste complète des appels se trouve à la fin.

Ouvrir les appels

hoody / bots

Bots

Parlez à vos Bots.
Ils pilotent les agents.

Un Bot est un assistant permanent, avec un seul chat qui garde toute la conversation. Demandez-lui ce que vous voulez : il lance des agents sur vos ordinateurs, suit leur travail et vous rend compte de ce qu’ils ont fait. Donnez-lui une URL .hoody.bot et partagez-la avec des personnes et des IA de confiance grâce à des clés nommées.

Votre premier Bot, chief, est là dès le départ. Hoody AI (gratuite) est intégrée. Ou connectez-vous avec ChatGPT. Les assistants du Bot peuvent utiliser Claude Pro ou Max via Claude Code quand vous les y autorisez.

Vue d’ensembleExemple
Vous

Corrigez la faute de frappe sur mon site et le prix de la boutique, puis triez les nouvelles photos.

Votre Bot

chiefun seul chat · anciens échanges résumés · vos limites

Agents

terminéCorriger la faute sur Mon site

vous demandeCorriger le prix de Boutique

en coursTrier les nouvelles photos

Vos ordinateurs
Mon site Boutique Photos

Chaque agent est une session Hoody Agent complète sur l’un de vos ordinateurs.

Concrètement

Votre premier Bot
GET /api/v1/agent/bots/chiefchief est créé à la première utilisation : la liste des Bots n’est donc jamais vide.
Où il s’exécute
https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/botsLes Bots s’exécutent sur Hoody Agent (agent-1), pas sur le service de chat à /api/bot/.
hoody / how it flows

Un seul message va jusqu’au bout. Un rapport vous revient.

Vous

depuis l’un de ces accès

RapportTerminé. Boutique est réparée.

Vos ordinateurs

Votre Bot

prend votre message tout de suite et vous rend compte quand c’est fini

Agent

ses assistants

Agent

ses assistants

  • Mon sitemise à jour
  • Boutiquecorrection
  • Photossauvegarde

ExempleTout cela s’exécute sur vos ordinateurs. Votre Bot connaît chacun d’eux.

Concrètement

Ses agents
GET /api/v1/agent/bots/chief/delegates?state=openChaque agent délégué est une session ordinaire, lue ou rattachée avec les routes /sessions. Les sessions ouvertes portent capability et current_step.
Son tour en direct
GET /api/v1/agent/sessions/{session_id}/streamLe texte de la réponse et la réflexion au fur et à mesure de l’écriture, les appels d’outils et la fin de chaque tour. session_id provient de GET /bots/{id} une fois que le Bot a reçu son premier message.
Plus : suivre un tour complet, un Bot à la fois

Vous demandez une fois. Il répartit le travail.

Il répond, lance des agents pour les tâches longues et revient vers vous avec leurs questions et leurs résultats.

Tour d’exemple

Vous, 09 h 12

Corrigez la faute de frappe du prix sur mon site. Et cherchez pourquoi le paiement est devenu lent sur la boutique.

Chief, 09 h 12

Je m’en occupe. J’ouvre deux agents : un sur Mon site pour la correction, un sur Boutique pour chronométrer le paiement. Je vous rendrai compte.

ouverture de 2 agents · Mon site, Boutique

Chief, 09 h 19

L’agent du site a corrigé la faute et veut exécuter ceci. L’autoriser ?

bash: ./publish.sh

Vous, 09 h 20

Oui, allez-y.

[rapport] L’agent du site a terminé : faute corrigée, site mis à jour.

Chief, 09 h 31

Terminé sur Mon site : la correction est en ligne. Le paiement attend une requête lente ; l’agent de la boutique a un correctif prêt à tester.

Écrivez à tout momentUn message envoyé pendant qu’il travaille attend son tour. Envoyez une correction : il lit les deux ensemble.
Travaille sur vos ordinateursLes agents s’exécutent là où se trouvent votre code et vos fichiers, et continuent quand vous fermez l’onglet.
Revient vous demanderLa demande d’un agent n’est approuvée que par un message de votre part, jamais par le rapport d’un agent.

Concrètement

Votre message
POST /api/v1/agent/bots/chief/messagesRépond 202 avec message_id, state et turn_id ; state: queued pendant que le Bot est occupé.
Sa réponse
GET /api/v1/agent/bots/chief/streamSSE : une trame state, puis une trame row par ligne de log ; reprise avec Last-Event-ID.
Arrêter un agent
POST /api/v1/agent/bots/chief/delegates/{sid}/stopArrêtez aussitôt le travail de cet agent, jamais le Bot. {"close": true} ferme aussi sa session.
Dites-le à voix haute
POST /api/v1/agent/bots/chief/messages/audioUn enregistrement wav ou mp3 est transcrit, puis envoyé comme votre message.
hoody / api

Donnez une URL publique à votre Bot. Connectez des personnes, des applications et des IA de confiance.

Une URL, trois accès : comme modèle pour les applications et SDK qui acceptent une URL de base (format OpenAI ou Anthropic), comme serveur MCP, ou en HTTP brut depuis un script.

chief · URL du Bot

https://<label>.hoody.bot
QR code d’un Bot, avec la marque du Bot au centre, tel que le Hub le dessine : un téléphone qui le scanne ouvre la page de chat du Bot. Cet exemple ouvre hoody.com/bots.

1Dans une application

Votre applicationIdentifiants d’exemple
Format
URL de base<Bot URL>/v1
Modèlebot:global/chief
Clé APIvotre clé hbk_
URL de base<Bot URL>
Modèlebot:global/chief
Clé APIvotre clé hbk_
URL du serveur<Bot URL>/mcp
TransportHTTP, POST pour chaque requête
Clé APIvotre clé hbk_

Chat completions, responses et models. Seul le dernier message de l’utilisateur est envoyé ; le prompt système et les réglages de l’application sont laissés de côté.

Messages et modèles, sur l’URL sans /v1. Seul le dernier message de l’utilisateur est envoyé ; le prompt système et les réglages de l’application sont laissés de côté.

Votre Bot comme serveur MCP : réponses JSON-RPC, aucune session à conserver et aucun flux d’événements.

2Depuis un script

HTTP brut

  • POST /bots/chief/messages

    Confiez-lui une tâche depuis un script, une tâche cron ou une autre IA.

  • GET /bots/chief/stream

    Suivez les réponses terminées et les événements des agents. Le flux de session du Bot affiche le texte de la réponse au fil de sa rédaction.

  • POST /bots/chief/delegates/{sid}/stop

    Arrêtez un agent ; le Bot continue.

3Qui a accès

Donnez une clé nommée à chaque personne ou application de confiance. Suspendez-la, fixez une date d’expiration ou une restriction IPv4, ou révoquez-la séparément.

Toutes les personnes qui ont une clé partagent une même conversation. Ne partagez qu’avec des personnes et des IA de confiance.

Limitez un Bot à un seul espace : ses agents ne voient que les ordinateurs de cet espace.

Concrètement

Base du Bot
https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/{realm}/{bot}OpenAI utilise <base>/v1, Anthropic la base, MCP <base>/mcp. {realm} vaut global ou un identifiant hexadécimal de 24 caractères. GET /bots/{id} les liste sous urls. Bot partagé : https://<label>.hoody.bot/v1/chat/completions avec une clé Bearer.
Envoyer un message
curl -X POST "<agent>/api/v1/agent/bots/chief/messages" -H "Authorization: Bearer <token>" -d '{"text":"Ship it"}'64 Kio de texte au maximum ; répond 202.
Arrêter un agent
POST /api/v1/agent/bots/chief/delegates/{sid}/stop {"close":true}Arrêtez un délégué, jamais le Bot.
hoody / guardrails

Des phrases simples. C’est toute la configuration.

Écrivez ce que votre Bot ne doit jamais faire, avec vos propres mots. Enregistrez. C’est fait.

  • Aucune syntaxe
  • Chaque agent la reçoit
  • Les tâches risquées sont vérifiées avant de démarrer

chief · garde-fousExemple

ne jamais envoyer sur main, ouvrir une PR et m’attendre ne pas toucher à la facturation, au DNS ni aux paiements la base de données de prod est en lecture seule si une tâche coûte plus de 20 $, s’arrêter et demander un doute ? me demander, ne pas deviner

Concrètement

Remplacer les garde-fous
PUT /api/v1/agent/bots/chief/guardrails {"guardrails":"Never push to main."}Un seul champ de texte ; le Bot reçoit chaque ligne marquée [guardrails updated] avant son message suivant.
Niveau de rigueur
"guardrail_check": "strict"strict (par défaut), lenient ou off. docs / api / agent / bots ↗

Concrètement

Envoyer de n’importe où
POST /api/v1/agent/bots/chief/messages {"text":"Is staging up?"}Répond 202 ; queued tant que le Bot est occupé. Ajoutez Idempotency-Key pour réessayer sans risque.
Reprendre le flux
GET /api/v1/agent/bots/chief/stream?since=154Server-Sent Events ; l’id de chaque trame de ligne est son seq, donc Last-Event-ID reprend seul.
Accès vocaux
…/bots/{id}/voice · …/bots/{id}/realtimeUne seule connexion vocale en direct par Bot à la fois ; takeover=true la remplace. docs / api / agent / bots ↗
Aller plus loin : le log
Exemple : quatre appareils, un Bot, un log

Quatre appareils sont ouverts sur le même Bot : un téléphone, un ordinateur portable, un terminal et une application d’IA. Le téléphone et l’ordinateur portable envoient au même moment, à 22 h 31 ; les messages arrivent en #152, puis #153, et le Bot répond en #154. Chaque appareil voit le même ordre. Les anciens échanges sont condensés en un court résumé, les lignes #1 à #120 ; les échanges les plus récents, #121 à #154, restent mot pour mot. Le log complet conserve chaque ligne.

Chaque appareil, une seule conversation. Votre téléphone, ordinateur portable, terminal et applications d’IA sont ouverts sur le même Bot en même temps, et chaque appareil voit le même ordre. Les détenteurs d’une clé partagent aussi cette conversation. Ne la partagez qu’avec des personnes de confiance.

Chaque message reçoit le numéro suivant. Deux messages envoyés au même moment arrivent en #152, puis #153. Un message envoyé pendant que le Bot est occupé attend son prochain tour.

Il ne manque jamais de place. Quand la fenêtre du modèle se remplit, les anciens échanges sont condensés en un court résumé, les plus récents restent mot pour mot, et le Bot continue. Le log conserve chaque ligne ; l’oubli les déplace vers l’archive.

Contenu d’une ligne
Chaque ligne contient seq, at, role (user, bot, event ou system) et text. Elle peut aussi contenir session_id. Le log est paginé par seq ; le flux envoie chaque nouvelle ligne dès son écriture.
Changer de modèle
Un nouveau modèle démarre à la prochaine session du Bot : la réinitialisation déplace le log vers l’archive et ouvre la nouvelle session. L’archive reste lisible jusqu’à ce que vous la purgiez.
Mémoire conservée par vos agents
Les agents enregistrent et recherchent aussi leur propre mémoire (par mot-clé, par sens et par liens entre éléments), qui n’est pas enfermée dans une seule application d’IA. docs / api / agent / memory ↗

Concrètement

Lire le log
GET /api/v1/agent/bots/chief/logLignes dans l’ordre, paginées par seq.
Le suivre
GET /api/v1/agent/bots/chief/streamUne trame state, puis les lignes ; un curseur déplacé vers l’archive répond lagged.
Oublier
POST /api/v1/agent/bots/chief/forgetLecture ultérieure avec GET …/archive ; suppression avec POST …/purge.
Aller plus loin : les hooks

Branchez un hook. Votre script voit l’appel en premier et la réponse en dernier.

Un hook fait passer d’abord les appels HTTP correspondants, destinés au Bot ou à la plupart des autres services sur vos ordinateurs, par l’un de vos scripts Exec. Les requêtes d’upgrade WebSocket sur un chemin correspondant sont refusées : gardez donc hors de la correspondance les chemins comme les accès vocaux du Bot. À l’entrée, il peut les surveiller, les vérifier, les modifier, y répondre ou les bloquer. À la sortie, il peut lire la réponse et la modifier avant que l’appelant la reçoive. Aucun correctif à appliquer.

Une boucle de l’appelant vers le Bot ou la plupart des autres services sur vos ordinateurs. Les appels entrent par le haut et les réponses reviennent par le bas. Un seul script Exec couvre les deux : il voit chaque appel à l’entrée et peut voir chaque réponse à la sortie. Chaque hook a une limite de temps, 500 ms par défaut.

EntréeÀ l’entrée

  • SurveillerJournalisez qui appelle et quoi, puis transmettez l’appel.Voir le scriptMasquer le script

    Règle : POST /api/v1/agent/bots/* → /bot-audit

    module.exports = async function (req, res, metadata) {
      if (!metadata.hook) {
        res.writeHead(404);
        return res.end();
      }
      const ip = req.headers['x-real-ip'];
      console.log(metadata.hook.auditId,
        metadata.hook.origPath, ip);
      await metadata.hook.forward(req, res);
    };

    Le script voit l’adresse IP réelle du client. Appelé sans hook, metadata.hook est vide, donc il répond 404. forward() transmet l’appel au Bot tel quel.

  • VérifierNe laissez passer que les personnes connectées. Une limite de débit se place au même endroit.Voir le scriptMasquer le script

    Règle : any method except OPTIONS /api/v1/agent/bots/* → /identity-gate

    module.exports = async function (req, res, metadata) {
      if (!metadata.hook) {
        res.writeHead(404);
        return res.end();
      }
      const user = verifyClaim(
        req.headers['x-hoody-claim']);
      if (!user) {
        res.writeHead(401);
        return res.end();
      }
      await metadata.hook.forward(req, res,
        { headers: {
          'x-hoody-claim': null,
          'x-hoody-user': user.username,
        } });
    };

    verifyClaim vérifie une assertion de connexion Hoody signée avec ED25519 ; la documentation contient le script complet. Toute personne sans assertion reçoit un 401 et n’atteint jamais le Bot. Cette règle refuserait aussi les chemins vocaux WebSocket : restreignez-la pour les exclure.

  • ModifierRéécrivez la méthode, le chemin, les en-têtes ou le corps avant l’arrivée de l’appel.
  • BloquerRefusez les envois qui échouent à l’analyse antivirus, ou les appels au-delà de votre limite.
  • RépondreRépondez vous-même, par exemple « De retour bientôt », et le Bot ne voit jamais l’appel.Voir le scriptMasquer le script

    Règle : POST /api/v1/agent/bots/* → /bot-gate

    module.exports = async function (req, res, metadata) {
      if (!metadata.hook) {
        res.writeHead(404);
        return res.end();
      }
      if (process.env.MAINTENANCE) {
        res.writeHead(503);
        return res.end('Back soon');
      }
      await metadata.hook.forward(req, res,
        { headers: { cookie: null } });
    };

    Une réponse envoyée par le script n’atteint jamais le Bot. forward() peut aussi modifier la méthode, le chemin, les en-têtes ou le corps ; un en-tête défini sur null est supprimé.

SortieÀ la sortie

  • Lire la réponseVoyez son statut, ses en-têtes et son corps avant l’appelant.
  • RéécrireTransmettez la réponse telle quelle, ou envoyez la vôtre.Voir le scriptMasquer le script

    Règle : any method except OPTIONS /api/v1/agent/bots/* → /bot-answer

    module.exports = async function (req, res, metadata) {
      if (!metadata.hook) {
        res.writeHead(404);
        return res.end();
      }
      const up = await metadata.hook.fetchUpstream(req);
      if (up.status === 401) {
        res.writeHead(401);
        return res.end('Please sign in again');
      }
      res.setHeader('x-hoody-hook-audit', metadata.hook.auditId);
      await metadata.hook.pipeResponse(up, res,
        { method: req.method });
    };

    fetchUpstream() récupère la réponse du Bot sans l’envoyer : le script la lit donc d’abord ; pipeResponse() la transmet. Une réponse en flux s’arrête à la limite de temps du hook, 30 000 ms au maximum.

  • Nettoyer les en-têtesRetirez les en-têtes privés des réponses, ajoutez une CSP.

Chaque hook a une limite de temps, 500 ms par défaut. Si le script échoue ou dépasse le temps imparti, l’appel s’arrête là. docs / proxy / hooks ↗

Concrètement

Ajouter un hook
POST /api/v1/computers/{id}/proxy/hooks/agent · If-Match: file:v<N> {"match":{"method":["POST"],"path":"/api/v1/agent/bots/*"},"script":{"path":"/bot-audit"},"timeout":500}Le serveur attribue son id au hook. Les règles s’appliquent dans l’ordre et la première qui correspond l’emporte.
Lire la version
GET /api/v1/computers/{id}/proxy/hooks/agentToute modification des hooks exige If-Match: file:v<N> avec la version actuelle.
Le script
POST /api/v1/exec/scripts/write {"path":"bot-audit.js","content":"module.exports = async function (req, res, metadata) { … }"}Le corps du script ne montre ici que la structure : mettez votre code d’audit à la place de { … }. script.path désigne un script de votre propre hoody-exec. Écrivez-le sur votre lien exec ; /bot-audit sert bot-audit.js. docs / api / exec / script-management ↗

Commencez gratuitement, en une ligne.

L’offre Free démarre sans carte bancaire : Hoody AI est intégrée, et l’IA que vous utilisez déjà fonctionne aussi.

Sans code
Code
Votre IA@https://hoody.com Connect to Hoody

Fonctionne dans ChatGPT, Claude ou toute IA capable de récupérer une page. Copiez-le et collez-le.

Votre IA
@https://hoody.com Connect to Hoody
docs / foundation / agent-skill-bundle
Navigateur
https://hub.hoody.com
docs / kit / agent
Terminal
ssh hoody.comTout appareil doté d’un client SSH, dans un terminal interactif. Rien à installer.
docs / kit / agent
Skill
npx skills add https://hoody.com/SKILLS/SKILL.mdnpx skills add HoodyNetwork/hoody-sdkLa seconde ajoute toutes les pages de la documentation sur le disque, pour un usage hors ligne.
docs / foundation / agent-skill-bundle
CLI
npm install -g hoody-sdkcurl -fsSL https://install.hoody.com | shLa seconde est pour Linux et macOS. Sans installation : npx hoody-sdk <command>
docs / foundation / cli
SDK
npm install hoody-sdkTypeScript. Node.js 20.19 ou plus récent, Bun, Deno.
docs / getting-started / quickstart
HTTP API
curl -H "Authorization: Bearer <token>" https://api.hoody.com/api/v1/computers/
docs / api / authentication
SDK navigateur
<script src="https://cdn.jsdelivr.net/npm/hoody-sdk/dist/hoody-sdk.browser.min.js"></script>Expose window.HoodySDK. Fixez une version en production et donnez aux pages des jetons à portée limitée et à courte durée de vie.
docs / getting-started / quickstart

Depuis 2021

De la confidentialité à l’infrastructure pour agents

hoody / kit

Ce que contiennent vos ordinateurs

Chaque service a son propre lien. Ouvrez-le, partagez-le ou confiez-le à votre IA. Toute personne qui a le lien peut l’ouvrir tant que vous ne le verrouillez pas. Les liens du Kit ont la forme https://{p}-{c}-<kit>-1.{node}.computers.hoody.com : {p} est votre projet, {c} l’un de vos ordinateurs, {node} son serveur.

Ordinateurs

Bots

API