git404hub

what is detectionforge- fr?

krovix-1902/detectionforge- — explained in plain English

Analysis updated 2026-05-18

18PythonAudience · researcherComplexity · 4/5LicenseSetup · moderate

tl;dr

An AI agent that reads threat intel reports and writes validated security detection rules automatically.

vibe map

mindmap
  root((DetectionForge))
    What it does
      Reads threat intel
      Writes Sigma rules
      Self-corrects errors
      Converts to SPL and Elastic
    Tech stack
      Python
      Gemini Flash
      pySigma
    Use cases
      Detection rule generation
      ATT&CK mapping
      Rule quality scoring
    Audience
      Security researchers
      SOC analysts

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 make with this?

VIBE 1

Turn a threat intelligence report into a Sigma detection rule automatically.

VIBE 2

Convert a generated detection rule into Splunk and Elastic query formats.

VIBE 3

Score a set of detection rules against a hand labeled ground truth for quality.

VIBE 4

Map threat behaviors described in a report to MITRE ATT&CK techniques.

what's the stack?

PythonGeminipySigmaMITRE ATT&CKPydantic

how it stacks up fr

krovix-1902/detectionforge-1038lab/comfyui-agnes-aiadityaarsharma/wordpress-malware-removal
Stars181818
LanguagePythonPythonPython
Setup difficultymoderateeasymoderate
Complexity4/52/53/5
Audienceresearcherdeveloperdeveloper

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

how do i run it?

Difficulty · moderate time til it works · 30min

Requires a free Google AI Studio API key and Python dependencies from requirements.txt.

You can use, modify, and share this freely, including commercially, as long as you give credit to the original author.

in plain english

DetectionForge is an AI agent that turns a written threat intelligence report into a detection rule that security teams can use to spot cyberattacks. It was built as a capstone project for a course on AI agents, focused on a real problem: security teams normally write these detection rules by hand, which is slow and error prone, while new threat information keeps arriving faster than teams can act on it. The agent reads a cyber threat intelligence report, pulls out indicators and attack techniques, maps them to the MITRE ATT&CK framework, which is a shared reference list of known attacker behaviors, and writes a detection rule in a format called Sigma. It then checks that rule with a validation tool, and if the rule fails validation, the agent reads the error and rewrites the rule itself, retrying up to three times. Once the rule passes, it gets converted into two other formats used by common security tools, Splunk and Elastic, so a human analyst can review and use it directly. The project runs on Google's Gemini Flash model and is built as a single agent with four tools it can call: fetching threat intel, mapping to ATT&CK, validating the Sigma rule, and converting it to other formats. It also includes a built in scoring system that grades each generated rule on whether it is syntactically valid, whether it correctly identifies the right ATT&CK techniques, whether it converts cleanly, and how specific it is. On a small hand labeled test set the project reports an average score of 0.75 out of 1. To run it, you need Python, a free Google AI Studio API key, and the packages listed in the requirements file. The author is explicit that the tool is meant to assist a human analyst, not replace one, and that generated rules should be reviewed before real world deployment. The code is released under the CC-BY 4.0 license and builds on existing open source projects including pySigma and MITRE ATT&CK data.

prompts (copy fr)

prompt 1
Help me set up DetectionForge with a Google AI Studio API key and run it on a sample threat report.
prompt 2
Explain how DetectionForge's self-correction loop fixes an invalid Sigma rule.
prompt 3
Walk me through building the full MITRE ATT&CK semantic index for DetectionForge.
prompt 4
How does DetectionForge's evaluation harness score a generated detection rule?
prompt 5
Show me how to port DetectionForge's tools to Google ADK.

Frequently asked questions

what is detectionforge- fr?

An AI agent that reads threat intel reports and writes validated security detection rules automatically.

What language is detectionforge- written in?

Mainly Python. The stack also includes Python, Gemini, pySigma.

What license does detectionforge- use?

You can use, modify, and share this freely, including commercially, as long as you give credit to the original author.

How hard is detectionforge- to set up?

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

Who is detectionforge- for?

Mainly researcher.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.