whatisgithub

What is t3mp3st?

elder-plinius/t3mp3st — explained in plain English

Analysis updated 2026-05-18

5,091TypeScriptAudience · researcherComplexity · 5/5LicenseSetup · moderate

In one sentence

A multi-agent framework that turns an AI coding agent into an authorized penetration-testing tool for finding security weaknesses.

Mindmap

mindmap
  root((T3MP3ST))
    What it does
      Multi-agent recon
      Automated exploit attempts
      Report generation
    Tech stack
      TypeScript
      Node.js
      Local or cloud AI agent
    Use cases
      Authorized penetration testing
      CTF challenge solving
      Security research
    Audience
      Security researchers
      Red teamers
    Caveats
      Authorized use only
      Some areas experimental

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run authorized security testing against web applications you own or have permission to test.

USE CASE 2

Solve capture the flag style security challenges with AI-driven automation.

USE CASE 3

Coordinate multiple AI agents through a recon, exploit, and report workflow.

USE CASE 4

Run offensive security testing fully offline using a locally hosted AI model.

What is it built with?

TypeScriptNode.jsOllamaDocker

How does it compare?

elder-plinius/t3mp3stkunagent/kunfacebook/astryx
Stars5,0915,0325,000
LanguageTypeScriptTypeScriptTypeScript
Last pushed2026-07-03
MaintenanceActive
Setup difficultymoderatemoderateeasy
Complexity5/53/52/5
Audienceresearcherpm founderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Needs Node.js, an AI coding agent connection or local model server, and is intended for authorized targets only.

Source is available and you can modify it, but AGPL-3.0 requires sharing modifications, including for network-accessible services, under the same license.

So what is it?

T3MP3ST is a framework that turns an AI coding agent you already use, such as Claude Code, Codex, or a locally run model, into a tool for offensive security testing. Offensive security means actively trying to find weaknesses in a computer system by attacking it in a controlled way, the same techniques a malicious hacker would use, but done with permission so the weaknesses can be fixed. The project describes itself as a multi-agent framework, meaning it coordinates several AI agents together to work through a process the README calls recon, exploit, and report, which means investigating a target, finding and demonstrating a weakness, then writing up what was found. The README is explicit and repeated in stating that T3MP3ST must only be pointed at systems you own or have explicit written permission to test, and that unauthorized use of these techniques against other people's systems is illegal in most places. It states the authors take no responsibility for misuse and provide the software with no warranty. A notable design choice is that it does not require its own paid API access. Instead it plugs into an AI coding agent you are already signed into, or it can run fully offline using a locally hosted model through tools like Ollama or LM Studio, so no new accounts or bills are needed. The README emphasizes that its performance claims can be independently re-checked by running a command that recalculates the numbers from data already committed in the project, rather than asking users to simply trust stated results. The project lists several areas it targets with different levels of completeness, including web applications and capture the flag style challenges, which it describes as stable, alongside newer and less finished areas like smart contracts, cloud infrastructure misconfigurations, mobile apps, and binary analysis, which it labels as experimental or still in progress. Getting started involves installing Node packages and running a local web based control panel called the War Room, where a target is described in plain English before a scan is launched.

Copy-paste prompts

Prompt 1
Walk me through setting up T3MP3ST's War Room and connecting it to a local AI agent.
Prompt 2
Explain what the recon, exploit, report workflow means in this project.
Prompt 3
Help me run T3MP3ST fully offline using Ollama instead of a cloud API key.
Prompt 4
What areas does T3MP3ST mark as stable versus experimental, and what does that mean?
Prompt 5
Show me how to run the verify-claims command to check this project's benchmark numbers.

Frequently asked questions

What is t3mp3st?

A multi-agent framework that turns an AI coding agent into an authorized penetration-testing tool for finding security weaknesses.

What language is t3mp3st written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, Ollama.

What license does t3mp3st use?

Source is available and you can modify it, but AGPL-3.0 requires sharing modifications, including for network-accessible services, under the same license.

How hard is t3mp3st to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is t3mp3st for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.