Installation

Requirements

• Python 3.9+
• Access to a BloodHound instance (Community or Enterprise) with API access enabled
• An IRRDBU00 unload from your mainframe (produced by the IRRDBU00 utility)

Install from PyPI

pip install racfhound

This installs the racfhound CLI and pulls in mfpandas and mfpandas-racfhound as dependencies.

Install from source

git clone https://github.com/JonathanPrince/racfhound
cd racfhound
pip install -e .

To also install the transformation library from source:

git clone https://github.com/JonathanPrince/mfpandas-racfhound
cd mfpandas-racfhound
pip install -e .

Verify

racfhound --version

BloodHound API token

RACFHound uses the BloodHound OpenGraph API. To obtain a token:

1. Log into BloodHound as an administrator.
2. Navigate to Administration → API Tokens.
3. Create a new token and copy it — it will not be shown again.

Pass the token via --token or set the RACFHOUND_TOKEN environment variable.