How joasasantos/neuropurple works
NeuroPurple is an autonomous SOC and purple-team engine, exposed through a conversational CLI. Its investigation workflow normalizes local or connected telemetry, extracts and enriches indicators, analyzes and hunts for evidence, verifies findings, and reports results. A parallel purple-team loop emulates ATT&CK techniques, checks detection coverage, and develops detection rules; SOAR adds analyst-approved response actions. The graph follows documented workflows and sampled calls; several README capabilities have no sampled implementation path or wiring, so their links are not asserted.
Main entry points: orchestrate.rs N1 Investigation · repl.rs Conversational REPL · purple.rs Purple Loop · hunt.rs Threat Hunting
Components 26
User Interface
- CLI Entry
app/src/main.rs - Conversational REPL
app/src/repl.rs
Investigation
- N1 Investigation
crates/harness/src/orchestrate.rs - Telemetry Sources
crates/harness/src/sources.rs - SIEM Connectors
crates/harness/src/connectors.rs - IOC Extraction
crates/harness/src/ioc.rs - Threat Intel
crates/harness/src/intel.rs - Log Analysis
crates/harness/src/analyze.rs - Threat Hunting
crates/harness/src/hunt.rs - N1 Triage
crates/harness/src/triage.rs - Incident Reports
crates/harness/src/incident.rs - Report Export
crates/harness/src/report.rs
Purple Team
- Purple Loop
crates/harness/src/purple.rs - BAS Emulation
crates/harness/src/emulate.rs - Detection Rules
crates/harness/src/detection.rs - Coverage Graph
crates/harness/src/coverage.rs - Reward Learning
crates/harness/src/rl.rs
Response Operations
- Approved SOAR
crates/harness/src/soar.rs - Action Guardrails
crates/harness/src/guardrails.rs - Response Sinks
crates/harness/src/sink.rs
Shared Services
- Operator Library
crates/harness/src/agents.rs - Model Pool
crates/harness/src/pool.rs - Results Dashboard
crates/harness/src/dashboard.rs - Cron Scheduler
crates/harness/src/cron.rs - On-Target Agents
crates/harness/src/agentgen.rs
Other components
- Analyst
Connections 28
- Analyst → CLI Entry: starts
README.md - CLI Entry → Conversational REPL: opens
app/src/main.rs - Conversational REPL → N1 Investigation: requests investigation
README.md - N1 Investigation → Telemetry Sources: ingests
crates/harness/src/orchestrate.rs - Telemetry Sources → SIEM Connectors: queries live sources
crates/harness/src/sources.rs - N1 Investigation → Threat Intel: enriches indicators
crates/harness/src/orchestrate.rs - N1 Investigation → Log Analysis: runs analysis
crates/harness/src/orchestrate.rs - N1 Investigation → Threat Hunting: runs hunt
crates/harness/src/orchestrate.rs - N1 Investigation → Incident Reports: records findings
README.md - N1 Investigation → Report Export: produces report
README.md - Log Analysis → IOC Extraction: extracts indicators
crates/harness/src/analyze.rs - Threat Hunting → IOC Extraction: pivots on indicators
crates/harness/src/hunt.rs - Threat Hunting → Telemetry Sources: searches pivots
crates/harness/src/hunt.rs - Conversational REPL → N1 Triage: routes triage
README.md - Conversational REPL → Purple Loop: starts purple loop
README.md - Purple Loop → BAS Emulation: runs technique
crates/harness/src/purple.rs - Purple Loop → SIEM Connectors: probes detections
README.md - Purple Loop → Detection Rules: authors rules
crates/harness/src/purple.rs - Purple Loop → Coverage Graph: updates coverage
README.md - Purple Loop → Reward Learning: updates reward
crates/harness/src/purple.rs - Conversational REPL → Approved SOAR: requests response
README.md - Approved SOAR → Action Guardrails: checks actions
crates/harness/src/soar.rs - Approved SOAR → Response Sinks: dispatches approved actions
crates/harness/src/soar.rs - N1 Investigation → Operator Library: uses operators
crates/harness/src/orchestrate.rs - N1 Investigation → Model Pool: requests model output
crates/harness/src/orchestrate.rs - Conversational REPL → Results Dashboard: opens dashboard
README.md - Conversational REPL → Cron Scheduler: schedules commands
README.md - Conversational REPL → On-Target Agents: generates agents
README.md