Skip to content

A community-driven repository for threat hunting ideas, methodologies, and research that serves as a central gathering place for hunters to share knowledge, collaborate on techniques, and advance the field of threat hunting.

Notifications You must be signed in to change notification settings

THORCollective/HEARTH-testing

 
 

Repository files navigation

HEARTH Logo

🔥 HEARTH: Hunting Exchange and Research Threat Hub 🔥

A community-driven, AI-powered exchange for threat hunting ideas and methodologies.
Explore the Live Database »

Submit a Hunt · Report a Bug · Request a Feature


📖 About The Project

HEARTH (Hunting Exchange and Research Threat Hub) is a centralized, open-source platform for security professionals to share, discover, and collaborate on threat hunting hypotheses. Generating effective and timely hunts is a major challenge, and HEARTH aims to solve it by building a comprehensive, community-curated knowledge base.

Our goal is to create a vibrant ecosystem where hunters can:

  • Discover new and creative hunting ideas.
  • Contribute their own research and CTI.
  • Collaborate with others to refine and improve detection strategies.
  • Automate the mundane parts of hunt creation and focus on what matters.

This project uses the PEAK Threat Hunting Framework to categorize hunts into three types:

  • 🔥 Flames: Hypothesis-driven hunts with clear, testable objectives.
  • 🪵 Embers: Baselining and exploratory analysis to understand an environment.
  • 🔮 Alchemy: Model-assisted and algorithmic approaches to threat detection.

✨ Key Features

HEARTH is more than just a list of hunts; it's a fully-featured platform with a sophisticated automation backend.

Feature Description
🔍 Interactive UI A searchable, filterable, and sortable database of all hunts, making it easy to find exactly what you're looking for.
🤖 AI-Powered CTI Analysis Submit a link to a CTI report, and our system uses GPT-4 to automatically read, analyze, and draft a complete hunt hypothesis for you.
🛡️ Duplicate Detection An AI-powered system analyzes new submissions against the existing database to flag potential duplicates and ensure content quality.
⚙️ Automated Workflows GitHub Actions manage the entire lifecycle of a submission, from initial draft to final approval, including creating branches and PRs.
🏆 Contributor Leaderboard We recognize and celebrate our contributors! An automated system tracks submissions and maintains a public leaderboard.
✅ Review & Regeneration Loop Maintainers can request a new version of an AI-generated hunt by simply adding a regenerate label to the submission issue.

🚀 How to Contribute

Contributing to HEARTH is designed to be as easy as possible. We use GitHub Issues as a streamlined submission hub.

Option 1: Automated CTI Submission (Recommended)

Have a link to a great threat intelligence report, blog post, or whitepaper? Let our AI do the heavy lifting.

  1. Click here to open a CTI Submission issue.
  2. Paste the URL to the CTI source and provide your name/handle for attribution.
  3. Submit the issue. Our bot will:
    • Read and analyze the content.
    • Generate a complete hunt draft.
    • Check for duplicates.
    • Post the draft in a new branch and comment on your issue with a link for review.

Option 2: Manual Hunt Submission

If you have a fully-formed hunt idea of your own, you can submit it manually.

  1. Click here to open a Manual Hunt Submission issue.
  2. Fill out the template with your hypothesis, tactic, references, and other details.
  3. Submit the issue for review by the maintainers.

Important

All approved submissions are integrated into the HEARTH database and credited to the submitter on our Contributors Leaderboard.


🛠️ Built With

HEARTH combines a simple frontend with a powerful, serverless backend built on GitHub Actions.

  • Frontend:
    • HTML5
    • CSS3
    • Vanilla JavaScript
  • Backend & Automation:
    • GitHub Actions
    • Python
    • OpenAI API (GPT-4)
  • Hosting:
    • GitHub Pages

License

Distributed under the MIT License. See LICENSE for more information.


❤️ Acknowledgements

This project is made possible by the security community and our amazing contributors.

Project Maintainers:

🔥 **Keep the HEARTH burning!** 🔥

About

A community-driven repository for threat hunting ideas, methodologies, and research that serves as a central gathering place for hunters to share knowledge, collaborate on techniques, and advance the field of threat hunting.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 55.7%
  • Python 31.5%
  • CSS 7.3%
  • HTML 5.5%