How avikengineer007/ai-threat-hunting-threat-intelligence-agent works
This is an autonomous threat-intelligence agent: scheduled or one-off collection feeds vulnerability, exploited-CVE, and ransomware data into a database; CVEs are analyzed, and a daily report is generated. The separate conversational CLI queries stored intelligence and can enrich IOCs on demand. The graph preserves documented capabilities whose implementation was not sampled; their edges are documented in the README or source index, not inferred from unsampled code.
Main entry points: jobs.py Scheduler · connection.py SQLite Database · gemini_client.py Gemini Reasoning · models.py Threat Models
Components 21
Collection
- Scheduler
scheduler/jobs.py - Collector Base
collectors/base.py - NVD Collector
collectors/nvd_collector.py - CISA KEV Collector
collectors/cisa_collector.py - Ransomware Collector
collectors/ransomware_collector.py
Intelligence Data
- Threat Models
database/models.py - SQLite Database
database/connection.py - Configuration
config.py
Analysis & Reports
- Conversation Agent
reasoning/agent.py - Reasoning Tools
reasoning/tools.py - Gemini Reasoning
reasoning/gemini_client.py - IOC Enrichers
collectors/enrichers.py - Report Generator
reporting/report_generator.py
User Interface
- Conversational CLI
cli.py - Daemon Entry
main.py
Other components
- NVD API
- CISA KEV Feed
- Google Gemini
- VirusTotal API
- Shodan API
- Analyst
Connections 31
- Daemon Entry → SQLite Database: initializes schema
main.py - Daemon Entry → Scheduler: runs job; starts
main.py - Scheduler → NVD Collector: runs collector
scheduler/jobs.py - Scheduler → CISA KEV Collector: runs collector
scheduler/jobs.py - Scheduler → Ransomware Collector: runs collector
scheduler/jobs.py - NVD Collector → NVD API: fetches CVEs
collectors/nvd_collector.py - CISA KEV Collector → CISA KEV Feed: collects KEV entries
README.md - NVD Collector → Threat Models: creates or updates
collectors/nvd_collector.py - CISA KEV Collector → Threat Models: updates CVE records
collectors/cisa_collector.py - Ransomware Collector → Threat Models: saves activity
collectors/ransomware_collector.py - Scheduler → Threat Models: queries and enriches CVEs
scheduler/jobs.py - Scheduler → Gemini Reasoning: analyzes CVEs
scheduler/jobs.py - Scheduler → Report Generator: generates report
scheduler/jobs.py - SQLite Database → Threat Models: creates schema
database/connection.py - Report Generator → SQLite Database: queries and saves report
reporting/report_generator.py - Report Generator → Gemini Reasoning: requests overview
reporting/report_generator.py - Gemini Reasoning → Google Gemini: generates analysis
reasoning/gemini_client.py - Analyst → Conversational CLI: asks questions
README.md - Conversational CLI → Conversation Agent: submits queries
cli.py - Conversation Agent → Reasoning Tools: uses tools
reasoning/agent.py - Reasoning Tools → SQLite Database: queries and saves
reasoning/tools.py - Reasoning Tools → IOC Enrichers: enriches IOC
reasoning/tools.py - Reasoning Tools → Gemini Reasoning: classifies IOC
reasoning/tools.py - IOC Enrichers → VirusTotal API: checks reputation
collectors/enrichers.py - IOC Enrichers → Shodan API: looks up host
collectors/enrichers.py - NVD Collector → Collector Base: inherits collection behavior
collectors/nvd_collector.py - CISA KEV Collector → Collector Base: inherits collection behavior
collectors/cisa_collector.py - Ransomware Collector → Collector Base: inherits collection behavior
collectors/ransomware_collector.py - Scheduler → Configuration: reads interval
scheduler/jobs.py - SQLite Database → Configuration: reads database URL
database/connection.py - Gemini Reasoning → Configuration: reads API key
reasoning/gemini_client.py