explaingit

popescoup/malicious-agent-behavior-emulator

Analysis updated 2026-05-18

1PythonAudience · researcherComplexity · 3/5LicenseSetup · moderate

TLDR

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

What do people build with it?

USE CASE 1

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

USE CASE 2

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

USE CASE 3

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

USE CASE 4

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

What is it built with?

PythonNetworkXAnthropic API

How does it compare?

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 get it running?

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.

In plain English

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.

Copy-paste 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

What 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.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.