Repository navigation
Actaeon v0.3.0-beta
Pre-releaseActaeon v0.3.0-beta: alert triage
Actaeon now triages alerts as well as hunting. Alerts come in through a webhook, a polled connector or an
import. They are suppressed, de-duplicated and grouped into cases, and each case is investigated through
the same read-only MCP connectors, models and checks as a hunt. The work was started as a separate project
(Haymdhal) and merged here, so both share one codebase.
What is new
- Cases with a checked verdict. True positive, false positive, benign, needs analyst or logs missing,
with the story, the findings tied to evidence, the facts that point against the verdict and what could
not be established, ATT&CK techniques, and a fix (remediation steps or a tuning proposal). - A second look tries to prove a true positive wrong and a serious dismissal right. A high or critical
alert is never dismissed without an independent confirmation: it waits for a person. - Graphs on every case: entity graph, timeline and ATT&CK chain; a triage dashboard with verdicts per
day, AI and analyst agreement, noisiest rules and tokens per day. - Approval-gated response actions, off by default. Actions you define (isolate, disable, block) are
proposed on true positives and run only after a person approves the exact call; never by whoever
proposed it, never after the case changed, never after the proposal expired. Undo is labelled
reversible or compensating. Destructive operations are never possible, and hunts still never see
response tools. - Sealed evidence bundle per case (alerts, every call and result with digests, verdict, decisions,
digests of every prompt and reply, audit rows). - Secret-shaped values are removed from every prompt for every provider, hunts included.
actaeon triage-benchon the demo cases or your own labelled alerts, with a per-model table.
Measured
On 9 labelled cases over real lab data, a 4B local model (qwen3:4b on a 4 GB GPU) found none of the 4
planted attacks and called them false positives. None was closed: the guards sent all four to an analyst
(0 wrong closures, 0 false alarms). Small local models cannot triage; larger models have not been measured
on alert triage yet. Details in docs/benchmarks.md.
Status
Beta, solo-maintained, not yet run in production. Read docs/known-limitations.md.
Install: pipx install actaeon (or pip install actaeon), then actaeon demo --offline --run.