OpenGraph collector framework for BloodHound
Project description
Build BloodHound data collectors with OpenHound's standardized, reproducible collect-first and transform-later pipeline.
About
OpenHound is a standardized framework for building OpenGraph collectors and converters. Built on DLT (Data Load Tool), it provides a consistent workflow for collecting, processing, and converting data from any source into BloodHound-compatible graphs. OpenHound enforces a collect-first, convert-later pipeline. Raw data collected from a source is always stored before transformation and ensures reproducibility. Custom decorators simplify collector development with minimal boilerplate, while CLI commands and graph documentation are automatically generated for every source.
Getting Started
Follow the docs for setup, CLI usage, and collector development:
- Overview: OpenHound Documentation
How it works
-
Collect: OpenHound uses DLT to collect resources from various services. Resources are parsed using a Pydantic model and stored as JSONL/Parquet on disk during the collection phase.
-
Pre-process: A DuckDB database can be (optionally) populated to store resources for OpenGraph convertion. The database can be used as a lookup to find, for example, all resources a particular user/group has permissions to.
-
Convert: The raw resources are read from disk and converted to OpenGraph nodes and edges.
Available extensions
Extend OpenHound with pre-built extensions for other services. Additional collectors can be installed using pip extras.
| Name | Source repo |
|---|---|
| Github | https://github.com/SpecterOps/openhound-github |
| JAMF | https://github.com/SpecterOps/openhound-jamf |
| Okta | https://github.com/SpecterOps/openhound-okta |
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file openhound-0.1.5rc2.tar.gz.
File metadata
- Download URL: openhound-0.1.5rc2.tar.gz
- Upload date:
- Size: 3.5 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.11.20 {"installer":{"name":"uv","version":"0.11.20","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1dcad3a257a49f737f48a18eed91b27a31c32ff6be97de851a526135b3734736
|
|
| MD5 |
6c68d37395c332b9cc7b7d5a2f509f6e
|
|
| BLAKE2b-256 |
eba97c7cf849c9dd04fab28993669dbbbeabe2fd28b0a36cd406c416e8b59094
|
File details
Details for the file openhound-0.1.5rc2-py3-none-any.whl.
File metadata
- Download URL: openhound-0.1.5rc2-py3-none-any.whl
- Upload date:
- Size: 65.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.11.20 {"installer":{"name":"uv","version":"0.11.20","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4ce420f97e986dff3ede27f7cd614c0a138805c7ff88a7e7765c2780b51e2391
|
|
| MD5 |
acfa6bbe8c4ef22b4ea8d59806aaf59c
|
|
| BLAKE2b-256 |
a0180bc875271850d7a2b76bf683c87da9f8f0b0e1a8ced904ab076cfd1770ea
|
