🌩️ T3MP3ST 🌩️

 ▄▄▄█████▓▓█████  ███▄ ▄███▓ ██▓███  ▓█████   ██████ ▄▄▄█████▓
 ▓  ██▒ ▓▒▓█   ▀ ▓██▒▀█▀ ██▒▓██░  ██▒▓█   ▀ ▒██    ▒ ▓  ██▒ ▓▒
 ▒ ▓██░ ▒░▒███   ▓██    ▓██░▓██░ ██▓▒▒███   ░ ▓██▄   ▒ ▓██░ ▒░
 ░ ▓██▓ ░ ▒▓█  ▄ ▒██    ▒██ ▒██▄█▓▒ ▒▒▓█  ▄   ▒   ██▒░ ▓██▓ ░
   ▒██▒ ░ ░▒████▒▒██▒   ░██▒▒██▒ ░  ░░▒████▒▒██████▒▒  ▒██▒ ░
   ▒ ░░   ░░ ▒░ ░░ ▒░   ░  ░▒▓▒░ ░  ░░░ ▒░ ░▒ ▒▓▒ ▒ ░  ▒ ░░
     ░     ░ ░  ░░  ░      ░░▒ ░      ░ ░  ░░ ░▒  ░ ░    ░
   ░         ░   ░      ░   ░░          ░   ░  ░  ░    ░
             ░  ░       ░               ░  ░      ░

Votre agent de codage IA est déjà un hacker — T3MP3ST lui met un arsenal entre les mains.

Pointez-le vers une cible autorisée et la kill chain s'exécute toute seule : recon → exploit → report, depuis une War Room dans le navigateur ou la CLI, pilotée par l'agent auquel vous êtes déjà connecté — Claude Code, Codex, Hermes — ou un modèle que vous exécutez entièrement hors ligne (Ollama, LM Studio, vLLM). Pas de nouvelles clés API, pas de tenant cloud, pas de deuxième facture. Votre agent est le cerveau ; T3MP3ST est la machine de guerre boulonnée autour. Tempête auto-hébergée. Guerre sans clé. ⚡

Et il ne vous demandera pas de le croire sur parole. Sur la suite de 104 défis de XBOW elle-même, il obtient 90,1 % de pass@1 — au-dessus des 85 % auto-déclarés par XBOW — en plus de résolutions de CTF sans indice et d'une chasse à froid sur de vraies CVE postérieures à la date de coupure que le modèle n'avait jamais vues. Chaque chiffre de ce README se recalcule à partir de données commitées avec une seule commande (npm run verify-claims). Assumé sur la mission, honnête sur la construction — le tableau de statut indique exactement ce qui est opérationnel, ce qui est de l'échafaudage et ce qui reste à la feuille de route ; toutes les preuves dans Benchmarks.

Trois choses le distinguent :

1. Reproductible. Chaque chiffre de ce README se recalcule à partir de données commitées — npm run verify-claims les redérive tous, 24/24 au vert. Une affirmation qui ne peut pas être reproduite n'est pas livrée. Jamais de chiffres « faites-moi confiance ».
2. Sans clé. L'agent de codage IA déjà sur votre machine est la colonne vertébrale. Pas de clés API, pas de deuxième facture, pas de gardien.
3. Honnête sur le périmètre. Le tableau de statut marque exactement ce qui est stable, expérimental ou à la feuille de route — parce que le red teaming ne devrait pas être un clergé, et ça ne devrait certainement pas reposer sur des impressions.

Aller à → Démarrage rapide · Ce qu'il chasse · Ce qui est livré aujourd'hui · Benchmarks · Architecture · Documentation

⚠️ Utilisation autorisée uniquement

T3MP3ST est un outil de sécurité offensif, conçu pour des tests, de la recherche et de l'éducation autorisés. Pointez-le uniquement vers des systèmes que vous possédez ou pour lesquels vous avez une autorisation écrite explicite de tester. L'accès non autorisé à des ordinateurs, des réseaux ou des données est illégal dans la plupart des juridictions — vous êtes seul responsable de l'utilisation que vous faites de ce logiciel et du respect de la loi et de vos règles d'engagement. Amenez la tempête sur vos cibles, pas sur celles des autres.

T3MP3ST est fourni tel quel sous licence AGPL-3.0, sans garantie ni responsabilité pour tout dommage, perte ou mauvaise utilisation. Les auteurs n'approuvent, ne soutiennent ni ne cautionnent les activités non autorisées. Obtenez la permission. Restez dans le périmètre. Ne soyez pas une menace. 🫡

Pourquoi il existe

La sécurité offensive reste inaccessible sans des années de pratique et des outils coûteux. Le pari derrière T3MP3ST est qu'un essaim d'agents coordonnés met la vraie chasse aux bugs à la portée des personnes qui n'ont jamais reçu l'invitation, dans les applications web, les CTF, les smart contracts, le code source et l'OSS embarqué/robotique. C'est un pari ambitieux, et les sections ci-dessous prennent soin de distinguer ce qui fonctionne déjà de ce qui reste un pari.

Ce qu'il chasse

Démarrage rapide

Le chemin le plus rapide vers une War Room opérationnelle (sans clé, ~2 min de configuration ; la durée de mission dépend de la cible) :

npm install
npm run server        # War Room → http://127.0.0.1:3333/ui/

Dans la War Room, ouvrez Settings et connectez un agent local (Claude Code / Codex / Hermes). Décrivez ensuite une cible à Op Admiral en anglais simple et lancez. L'agent que vous avez connecté est le cerveau. Aucune clé requise.

Vous préférez utiliser une clé ? Définissez-en une et sautez l'étape de connexion :

export OPENROUTER_API_KEY=...     # or VENICE_API_KEY / ANTHROPIC_API_KEY / OPENAI_API_KEY
export XAI_API_KEY=...            # Grok Build (grok-build-0.1) — xAI's coding model, native tool-calling

On peut donner plus de marge aux agents locaux lents avec T3MP3ST_LOCAL_AGENT_TIMEOUT_MS pour chaque appel CLI, T3MP3ST_TASK_TIMEOUT_MS pour les tâches de mission et T3MP3ST_GENERAL_TIMEOUT_MS pour les requêtes de planification. Les valeurs sont en millisecondes.

Ou exécutez-le entièrement hors ligne sur votre propre modèle — pas de clé, pas de cloud. Ollama par défaut ; pointez-le vers n'importe quel serveur compatible OpenAI (LM Studio, vLLM, llama.cpp) :

ollama serve && ollama pull llama3                          # or an OpenAI-compatible server
export TEMPEST_LOCAL_BASE_URL=http://localhost:11434/api    # LM Studio: http://localhost:1234/v1
export TEMPEST_LOCAL_MODEL=llama3
npx tempest                                                 # → "Change default provider" → local

L'appel d'outils fonctionne sur n'importe quel modèle local (il est piloté par texte), donc l'Arsenal tourne même sur des modèles sans appel de fonction natif.

Vérifiez les chiffres par vous-même :

npm run verify-claims             # re-derives every headline from committed JSON in bench/

L'utilisation en bibliothèque/SDK, l'API HTTP complète et la configuration MCP se trouvent dans docs/.

Ce qui est livré aujourd'hui

Le framework est une kill chain à 8 opérateurs, et ce tableau ne va pas vous enfumer. La recon est un moteur opérationnel, adossé à de vrais outils — et les dents sont déjà bien réelles : 90,1 % de pass@1 sur XBEN, 8/10 CVE postérieures à la date de coupure, mises de côté, épinglées sur le fichier/ligne/CWE exacts, et un pipeline de divulgation coordonnée suffisamment opérationnel pour avoir, en ce moment même, des brouillons en attente de coordination avec les éditeurs. Ce qui n'est pas prouvé, c'est l'essaim. Chaque opérateur en aval — Exploiter, Infiltrator, Exfiltrator, Ghost — exécute la même boucle ReAct réelle adossée à des outils que la recon (de vrais outils d'exploitation, pas des stubs), mais les chiffres phares proviennent d'un agent unique, pas de la cellule coordonnée à 8 opérateurs, et l'exploitation d'essaim de bout en bout n'est pas benchmarkée et reste peu fiable. Le moteur est réel ; l'essaim est la partie qui doit encore faire ses preuves. Nous clamons haut et fort là où nous l'avons mérité, et nous sommes directs sur le reste.

Détail complet fonction par fonction : FEATURES.md.

Couverture par domaine

Là où la tempête frappe aujourd'hui — et où elle se dirige. Même discipline que partout ailleurs : un domaine n'est ✅ que lorsqu'il y a une preuve derrière.

L'architecture classe/escouade signifie que les nouveaux domaines se composent plutôt qu'ils ne forker — chacun est un loadout (classes spécialisées + arsenal + adaptateur de cible + un benchmark). Les domaines 🚧 sont livrés dans l'ombre jusqu'à ce qu'ils aient un chiffre.

Benchmarks

Résultats phares. Chacun se recalcule à partir du JSON commité avec npm run verify-claims ; la méthodologie complète et les réserves figurent dans les docs liées.

Comment lire ces résultats :

• Chaque flag résolu est noté par rapport à un oracle de vérité terrain commité — pas une auto-déclaration — et verify-claims recalcule le succès/échec. Les transcriptions brutes par étape sont supprimées pour la confidentialité des opérateurs, donc vous revérifiez le verdict noté, pas la sortie brute des outils. Zéro fabrication, imposé par un garde-fou anti-surajustement qui s'exécute à chaque push.
• Black-box (source retenue) et white-box (source préparée) sont rapportées séparément et jamais mélangées.
• Ces résultats ont été obtenus avec une boucle ReAct à agent unique, pas l'essaim à 8 opérateurs. L'essaim est l'architecture du framework ; ce n'est pas lui qui a obtenu ces chiffres.
• Les résultats sont système-contre-système : ce harnais pilotant un modèle actuel puissant, pas une affirmation d'un harnais isolé.

Le chiffre n'est pas la démonstration — la preuve l'est. Un harnais open-source sans clé qui vous donne la re-exécution au lieu de vous demander de lui faire confiance : clonez-le, lancez npm run verify-claims, et chaque verdict ci-dessus se recalcule à partir de son oracle commité sous vos yeux.

Lecture approfondie : WALL_FORENSICS (échecs par défi), CYBENCH, INTEGRITY_LEDGER (audit de contamination et chaque rétractation), OBSIDIVM (notre propre cyber range web en direct).

Documentation

Architecture

┌─────────────────────────────────────────────────────────────────┐
│                        T3MP3ST COMMAND                          │
├─────────────────────────────────────────────────────────────────┤
│   MISSION CONTROL  ◄──  TARGET MODEL  ──►  ARSENAL (TOOLS)       │
│                          ▲                                       │
│   AGENT CELL:  RECON · SCANNER · EXPLOITER · INFILTRATOR ·       │
│                EXFILTRATOR · GHOST · COORDINATOR · ANALYST       │
│                          ▲                                       │
│   EVIDENCE VAULT  ·  CREDENTIAL STORE  ·  FINDINGS LEDGER        │
│                          ▲                                       │
│   OPSEC LAYER  ·  COMMS CHANNEL  ·  LLM BACKBONE                 │
└─────────────────────────────────────────────────────────────────┘

Les opérateurs correspondent aux phases MITRE ATT&CK et Cyber Kill Chain (la recon est opérationnelle ; les phases ultérieures sont échafaudées) :

Fournisseurs : OpenRouter, Venice, Anthropic, OpenAI, ou un agent local sans clé (Claude Code / Codex / Hermes). Définissez OPENROUTER_API_KEY / VENICE_API_KEY / ANTHROPIC_API_KEY, ou connectez un agent dans Settings.

Intégrations : node dist/mcp-server.js expose security_recon aux agents compatibles MCP. npm run server démarre l'API HTTP (POST /api/mission/start, GET /api/mission/status, et plus encore). Référence complète dans docs/.

Contribuer — rejoignez l'essaim

Le red teaming ne devrait pas être un clergé. Apportez un adaptateur, un pack de prompts, un runbook, un nouvel outil d'arsenal ou un rapport de bug.

Une règle, non négociable : tout ici est destiné uniquement aux tests autorisés. Cibles possédées, dans le périmètre ou consentantes. Construisez pour les défenseurs, ou ne construisez pas ici.

1. Forkez-le, créez une branche.
2. Ouvrez une PR avec des tests. Si vous touchez à un chiffre phare, npm run verify-claims doit rester au vert.

Processus de release et portes : RELEASE_CHECKLIST.

Licence

AGPL-3.0. Voir LICENSE.