gitwtfhub

wtf is nemesis?

specterops/nemesis — explained in plain English

Analysis updated 2026-07-20 · repo last pushed 2026-07-11

986PythonAudience · ops devopsComplexity · 4/5ActiveSetup · hard

TL;DR

A data-processing platform for offensive security teams that ingests files collected during network break-ins, extracts useful patterns like credentials and config data, and makes everything searchable for analysts and AI assistants.

Mindmap

mindmap
  root((repo))
    What it does
      Ingests collected files
      Extracts credentials
      Makes data searchable
    Tech stack
      Python
      Docker
      Dapr distributed toolkit
    Use cases
      Red team engagements
      Penetration testing
      File analysis pipeline
    Audience
      Security consultants
      Offensive security teams
    Architecture
      Containerized services
      Parallel file processing
      AI assistant integration

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

Feed hundreds of files extracted from a compromised network into the pipeline instead of opening each one manually.

REASON 2

Surface credentials, Active Directory relationships, and interesting registry keys from raw data collected during an engagement.

REASON 3

Let human analysts and AI assistants collaboratively search through enriched results to find the next attack target.

REASON 4

Centralize scattered security engagement data so a team can connect dots they might otherwise miss.

What's in the stack?

PythonDockerDapr

How it stacks up

specterops/nemesisfuture-agi/future-agizai-org/scail
Stars986979955
LanguagePythonPythonPython
Last pushed2026-07-11
MaintenanceActive
Setup difficultyhardmoderatehard
Complexity4/54/55/5
Audienceops devopsdeveloperresearcher

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

How do you spin it up?

Difficulty · hard Time to first run · 1h+

Requires Docker and Dapr distributed application runtime, with containerized services needing configuration and potentially significant infrastructure resources.

No license information is provided in the explanation, so usage rights are unclear.

Wtf does this do

Nemesis is a tool for offensive security teams, the people hired to break into networks the way real attackers would. During these engagements, testers collect a massive pile of files: stolen credentials, registry dumps, configuration files, and more. The project acts as a centralized hub that takes all that scattered data, processes it, and makes it searchable and analyzable so a team can quickly figure out what they've got and where to strike next. Think of it as a private, internal version of VirusTotal built specifically for red teamers and penetration testers. VirusTotal is the public service where anyone can upload a file and see what dozens of antivirus engines think about it. This platform does something similar, but it's designed for the opposite perspective: instead of defending against malware, it helps the attackers understand the files they've pulled from a target environment. It ingests the collected files, enriches them by pulling out useful patterns and structured information, and then lets both human analysts and AI assistants dig through the results collaboratively. The typical users are security consultants working on multi-day engagements. For example, if a tester compromises a workstation and extracts hundreds of files from the corporate network, they can feed everything into this system rather than manually opening each file. The pipeline then surfaces things like credentials, active directory relationships, or interesting registry keys, helping the team connect dots they might otherwise miss in a sea of raw data. The project is built using Docker and integrates heavily with Dapr, a toolkit for building distributed applications. This architecture choice lets it run as a set of containerized services that can process files in parallel and scale up when needed. The README points to a quickstart guide and usage guide for the actual setup and operational details, and the project has been through several iterations, with version 2.0 representing a significant rewrite from the original release.

Yoink these prompts

Prompt 1
Set up Nemesis using Docker and Dapr for a red team engagement, following the quickstart guide to ingest files extracted from a compromised workstation.
Prompt 2
Feed a directory of registry dumps and config files into Nemesis and search the enriched output for credentials and Active Directory relationships.
Prompt 3
Use the Nemesis platform to ingest stolen files from a penetration test, then query the processed results to identify what credentials and network relationships were found.
Prompt 4
Deploy Nemesis as a containerized service stack and configure it to process collected engagement files in parallel so a team can analyze them collaboratively.

Frequently asked questions

wtf is nemesis?

A data-processing platform for offensive security teams that ingests files collected during network break-ins, extracts useful patterns like credentials and config data, and makes everything searchable for analysts and AI assistants.

What language is nemesis written in?

Mainly Python. The stack also includes Python, Docker, Dapr.

Is nemesis actively maintained?

Active — commit in last 30 days (last push 2026-07-11).

What license does nemesis use?

No license information is provided in the explanation, so usage rights are unclear.

How hard is nemesis to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is nemesis for?

Mainly ops devops.

View the repo → Decode another repo

This repo across BitVibe Labs

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