Skip to content

deathlabs/hades

Repository files navigation

Harnessing AI to Disrupt and Evaluate Security (HADES)

HADES Logo

Introduction

HADES is a cyber adversary emulation app. It's for when cyber defenders need a red team to practice against, but they can't afford to coordinate or host one.

Have you ever been told you have to wait for an annual training exercise to test your mettle against a realistic threat? What about funding? Do you need a dirt cheap option for developing your blue team skills where your tools are? Then, HADES is for you!

HADES was built by a cyber defender who was tired of being a "blue team bench warmer" and eager to defend the network.

Getting Started

Follow the steps below if you want to run HADES (these instructions assume you already have git, make, and docker installed as well as a valid OpenAI API key). For more information, please read the docs.

Step 1. Clone this repository and then, change directories to it.

git clone https://github.com/deathlabs/hades
cd hades

Step 2. Create a file called .env.local.secrets in the same directory as the provided .env.local file is located. Then, add the content below to it. Ensure the value used for OPENAI_API_KEY is an actual OpenAI API key.

RABBITMQ_USERNAME=hades
RABBITMQ_PASSWORD=hades
OPENAI_API_KEY=sk-...

Step 3. Build all the containers that makeup HADES using the provided Makefile.

make

Step 4. Start HADES using the command below using the provided Makefile.

make start

Credits

  • Collin Siebener is the artist who created the HADES logo
  • Various icons used in HADES' architecture diagram were borrowed from Freepik

About

Harnessing AI to Disrupt and Evaluate Security (HADES)

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published