Skip to content

01rabbit/Azazel-Edge

Repository files navigation

AZ-01 Azazel-Edge - Deterministic Edge SOC/NOC Gateway

Codename: SENTINEL

Azazel-Edge Banner CI Release License: MIT Docs Platform: Raspberry Pi Python Rust Flask Black Hat Arsenal

Azazel-Edge is the AZ-01 core platform of the Azazel system, a Raspberry Pi-oriented deterministic edge SOC/NOC gateway and Cyber Scapegoat Gateway for constrained, temporary, and high-risk networks.

It observes local network evidence, evaluates NOC/SOC state deterministically, selects bounded actions (observe, notify, throttle, redirect, isolate), and records operator-visible explanations and audit traces.

Optional local AI assist may summarize or explain events, but it does not replace the deterministic decision loop.

Azazel-Edge is not a production SIEM replacement, not an autonomous AI defender, and not a promise of complete attack prevention.

Who this is for: security operators, field defenders, incident responders, training teams, and researchers working with constrained local networks.

2025 -> 2026 evolution line:

  • Deployable focus (rapid portable edge setup) -> Auditable focus (explainable deterministic decisions, rejected alternatives, and reviewable trace evidence)

Requirements

Requirement Detail
Hardware Raspberry Pi-oriented; tested/developed for constrained edge deployment
OS Raspberry Pi OS / Linux
Runtime Python 3.10+, Rust core components
Network Local edge segment with optional Suricata/OpenCanary integration
Optional Ollama, Mattermost, Wazuh, Vector, Aggregator

Quick Start

cd /home/azazel/Azazel-Edge
sudo ENABLE_INTERNAL_NETWORK=1 \
     ENABLE_APP_STACK=1 \
     ENABLE_AI_RUNTIME=1 \
     ENABLE_DEV_REMOTE_ACCESS=0 \
     bash installer/internal/install_all.sh

Minimal verification:

sudo systemctl status azazel-edge-web azazel-edge-control-daemon azazel-edge-core --no-pager

Detailed install/deploy guidance:

Architecture Overview

flowchart LR
    E[Event Inputs] --> P[Evidence Plane]
    P --> N[NOC Evaluator]
    P --> S[SOC Evaluator]
    N --> A[Action Arbiter]
    S --> A
    A --> X[Decision Explanation]
    X --> O[Operator Plane]
    X --> G[AI Assist Governance]
    G --> L[Local LLM Optional]
    A --> U[Audit Logger]
Loading

Full architecture:

What Azazel-Edge does

  • runs a local edge gateway and operations surface
  • ingests local telemetry such as Suricata EVE
  • evaluates NOC and SOC state through deterministic evaluators
  • selects bounded actions through an Action Arbiter
  • records explanations, alternatives, and audit traces
  • supports replay-safe demos and operator workflows
  • optionally uses local AI assist for summaries and triage hints

Security Boundary Summary

Azazel-Edge claims:

  • local-first deterministic decision support
  • explicit bounded actions
  • operator-visible explanation and audit traces
  • optional AI assist that remains secondary to deterministic control

Azazel-Edge does not claim:

  • complete attack prevention
  • full SIEM replacement
  • autonomous AI defense
  • legal or regulatory compliance by itself
  • safe deployment without operator understanding

Concept Profiles

Azazel-Edge is maintained as a single core platform. Different operational profiles are documented as concept profiles, not forks.

Candidate CFP and planning material:

Arsenal Demonstrations

Only accepted and public Black Hat Arsenal appearances are recorded here.

See Arsenal Demonstration History.

Documentation Map

Primary entry points:

Repository Layout

Path Role
py/azazel_edge/ Evidence Plane, evaluators, arbiter, explanations, audit
py/azazel_edge_control/ Control daemon and action handlers
py/azazel_edge_ai/ AI agent integration and M.I.O. assist path
azazel_edge_web/ Flask backend, dashboard, ops-comm UI
rust/azazel-edge-core/ Rust defense core
runbooks/ Runbook registry
concept_profiles/ Concept-to-configuration mapping layer
demos/concepts/ Concept-oriented deterministic demo grouping
docs/ Architecture, concept, operations, and reference documentation

License

MIT. See LICENSE.

About

Emergency SOC/NOC gateway for Raspberry Pi — deterministic triage + local AI assist (Ollama)

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors