gitwtfhub

wtf is malicious-agent-behavior-emulator?

popescoup/malicious-agent-behavior-emulator — explained in plain English

Analysis updated 2026-05-18

1PythonAudience · researcherComplexity · 3/5LicenseSetup · moderate

TL;DR

MABE generates labeled synthetic security event logs that simulate an AI-driven attacker's fast, exhaustive network traversal alongside normal user activity, for training and testing detection systems.

Mindmap

mindmap
  root((MABE))
    What it does
      Synthetic attack logs
      Benign vs AI-attack sessions
      Ground truth labels
    Tech stack
      Python
      NetworkX
      Anthropic API
    Signatures
      Velocity
      Exhaustive traversal
    Outputs
      Splunk CIM
      EVTX
      Timesketch

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

Why would anyone build with this?

REASON 1

Generate labeled synthetic security logs contrasting normal user activity with simulated AI-driven network attacks.

REASON 2

Test whether a detection system can tell an AI attacker's exhaustive, high-speed traversal apart from a human attacker's targeted movement.

REASON 3

Export a generated dataset in Splunk CIM, EVTX-compatible, or Timesketch formats for use in existing security tools.

REASON 4

Validate detection logic against ground truth labels for baseline deviation, traversal pattern, and velocity.

What's in the stack?

PythonNetworkXAnthropic API

How it stacks up

popescoup/malicious-agent-behavior-emulator0xustaz/streamgatea-bissell/unleash-lite
Stars111
LanguagePythonPythonPython
Setup difficultymoderatehardhard
Complexity3/54/54/5
Audienceresearcherdeveloperresearcher

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

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Needs an Anthropic API key once, only for generating the initial name vocabulary, later runs need no API access.

Permissive open-source license, free to use, modify, and redistribute, including commercially.

Wtf does this do

Malicious Agent Behavior Emulator, or MABE, is a Python tool that generates fake but realistic security log data for training and testing systems that try to detect AI driven cyberattacks. Rather than recording real attacks, it simulates a network with normal employees going about their work alongside a small number of sessions where an AI agent is exploring the network after having already broken in, and it produces detailed labeled logs of both kinds of activity. The project exists because, as of when it was written, there was no public dataset that captured how an AI conducting an attack behaves differently from a human doing the same thing. The author identifies two key differences. First, AI agents move through a network far faster than a human attacker, working at something like 47 to 158 times the speed based on published research. Second, AI agents tend to explore a network exhaustively, checking every reachable system, rather than moving with a specific target in mind the way a human attacker usually does. Every behavioral parameter used in the simulation is tied back to a cited published source, such as security research reports and academic papers, rather than being invented. Running MABE simulates a default network of 60 machines split across workstations, servers, and infrastructure systems, and generates a configurable number of normal and attack sessions. Output logs are written in formats compatible with common security tools such as Splunk and Windows event logs, and each session includes ground truth labels stating which parts of the activity were benign and which were the simulated attack, which makes the dataset useful for training or testing detection systems built around three ideas: whether an account is behaving unusually compared to its history, whether its movement pattern looks exploratory rather than purposeful, and whether its speed looks more like a machine than a person. Setup requires Python 3.11 or newer and, for one time use only, an Anthropic API key to generate a vocabulary of realistic names, every simulation run after that uses cached data and makes no further API calls. The project is released under the MIT license.

Yoink these prompts

Prompt 1
Show me how to run MABE with 100 benign sessions and 20 attack sessions using a fixed random seed.
Prompt 2
Explain the difference between MABE's velocity signature and its traversal pattern signature for AI-driven attacks.
Prompt 3
Walk me through the empirical sources MABE cites for its 47 to 158x velocity multiplier.
Prompt 4
Help me add a new node type to MABE's network topology configuration.

Frequently asked questions

wtf is malicious-agent-behavior-emulator?

MABE generates labeled synthetic security event logs that simulate an AI-driven attacker's fast, exhaustive network traversal alongside normal user activity, for training and testing detection systems.

What language is malicious-agent-behavior-emulator written in?

Mainly Python. The stack also includes Python, NetworkX, Anthropic API.

What license does malicious-agent-behavior-emulator use?

Permissive open-source license, free to use, modify, and redistribute, including commercially.

How hard is malicious-agent-behavior-emulator to set up?

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

Who is malicious-agent-behavior-emulator for?

Mainly researcher.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.