# murugavel03/airex-edge-reliability architecture

> Architecture diagram of the GitHub repository murugavel03/airex-edge-reliability, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/murugavel03/airex-edge-reliability
- Repository: https://github.com/murugavel03/airex-edge-reliability

## Overview

AIRE-X is an offline, voice-controlled assistive runtime reliability framework. Its main workflow recognizes speech, classifies a command, conditionally checks visual presence or vocal urgency, fuses available signals, applies safety-tiered ACCEPT/FLAG/BLOCK guardrails, and executes the resulting decision through an actuator. Telemetry records pipeline outcomes, while the evaluation capability includes ablation studies and figure generation. The main entry point and README document the orchestration; some implementation details are unsampled, so the graph avoids inferring unshown calls.

Main entry points: [`main.py`](https://github.com/murugavel03/airex-edge-reliability/blob/main/main.py) (Pipeline entry), [`airex/config.py`](https://github.com/murugavel03/airex-edge-reliability/blob/main/airex/config.py) (Safety configuration), [`airex/actuator/controller.py`](https://github.com/murugavel03/airex-edge-reliability/blob/main/airex/actuator/controller.py) (Actuator controller), [`evaluation/run_evaluation.py`](https://github.com/murugavel03/airex-edge-reliability/blob/main/evaluation/run_evaluation.py) (Evaluation runner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Runtime pipeline"]
  node_main["Pipeline entry<br/>[main.py]"]
  node_asr["Offline ASR<br/>[vosk_engine.py]"]
  node_intent["Intent classifier<br/>[classifier.py]"]
  node_visual["Visual presence<br/>[presence.py]"]
  node_urgency["Vocal urgency<br/>[urgency.py]"]
end

subgraph group_safety["Reliability and safety"]
  node_fusion["Signal fusion<br/>[uncertainty.py]"]
  node_guardrails["Decision guardrails"]
  node_config["Safety configuration<br/>[config.py]"]
end

subgraph group_execution["Actions and telemetry"]
  node_actuator["Actuator controller<br/>[controller.py]"]
  node_telemetry[("CSV telemetry<br/>[logger.py]")]
end

subgraph group_evaluation["Evaluation"]
  node_evaluation["Evaluation runner<br/>[run_evaluation.py]"]
  node_ablation["Ablation study<br/>[ablation.py]"]
  node_figures["Figure generation"]
end

node_user(("Voice user"))
node_microphone(("Microphone"))
node_camera(("Camera"))
node_device(("Controlled devices"))

node_user -->|"speaks into"| node_microphone
node_microphone -->|"supplies audio"| node_asr
node_camera -->|"provides frames"| node_visual
node_main -->|"invokes"| node_asr
node_main -->|"invokes"| node_intent
node_main -->|"conditionally invokes"| node_visual
node_main -->|"conditionally invokes"| node_urgency
node_main -->|"invokes"| node_fusion
node_main -->|"invokes"| node_guardrails
node_main -->|"dispatches decision"| node_actuator
node_main -->|"logs outcomes"| node_telemetry
node_main -->|"runs evaluation mode"| node_evaluation
node_evaluation -->|"runs study"| node_ablation
node_evaluation -->|"generates figures"| node_figures
node_actuator -.->|"controls optionally"| node_device
node_asr -->|"reads settings"| node_config
node_intent -->|"reads definitions"| node_config
node_visual -->|"reads settings"| node_config
node_urgency -->|"reads settings"| node_config
node_fusion -->|"reads weights"| node_config
node_guardrails -->|"reads thresholds"| node_config
node_actuator -->|"reads decision type"| node_config
node_telemetry -->|"reads settings"| node_config

click node_main "https://github.com/murugavel03/airex-edge-reliability/blob/main/main.py"
click node_asr "https://github.com/murugavel03/airex-edge-reliability/blob/main/airex/asr/vosk_engine.py"
click node_intent "https://github.com/murugavel03/airex-edge-reliability/blob/main/airex/intent/classifier.py"
click node_visual "https://github.com/murugavel03/airex-edge-reliability/blob/main/airex/visual/presence.py"
click node_urgency "https://github.com/murugavel03/airex-edge-reliability/blob/main/airex/vocal/urgency.py"
click node_fusion "https://github.com/murugavel03/airex-edge-reliability/blob/main/airex/fusion/uncertainty.py"
click node_guardrails "https://github.com/murugavel03/airex-edge-reliability/blob/main/airex/guardrails/decision_manager.py"
click node_config "https://github.com/murugavel03/airex-edge-reliability/blob/main/airex/config.py"
click node_actuator "https://github.com/murugavel03/airex-edge-reliability/blob/main/airex/actuator/controller.py"
click node_telemetry "https://github.com/murugavel03/airex-edge-reliability/blob/main/airex/telemetry/logger.py"
click node_evaluation "https://github.com/murugavel03/airex-edge-reliability/blob/main/evaluation/run_evaluation.py"
click node_ablation "https://github.com/murugavel03/airex-edge-reliability/blob/main/evaluation/ablation.py"
click node_figures "https://github.com/murugavel03/airex-edge-reliability/blob/main/evaluation/generate_figures.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_main,node_asr,node_intent,node_visual,node_urgency,node_user toneBlue
class node_fusion,node_guardrails,node_config toneAmber
class node_actuator,node_telemetry toneMint
class node_evaluation,node_ablation,node_figures toneRose
class node_microphone,node_camera,node_device toneIndigo
```

## Components

### Runtime pipeline

- [Pipeline entry](https://github.com/murugavel03/airex-edge-reliability/blob/main/main.py): `main.py`
- [Offline ASR](https://github.com/murugavel03/airex-edge-reliability/blob/main/airex/asr/vosk_engine.py): `airex/asr/vosk_engine.py`
- [Intent classifier](https://github.com/murugavel03/airex-edge-reliability/blob/main/airex/intent/classifier.py): `airex/intent/classifier.py`
- [Visual presence](https://github.com/murugavel03/airex-edge-reliability/blob/main/airex/visual/presence.py): `airex/visual/presence.py`
- [Vocal urgency](https://github.com/murugavel03/airex-edge-reliability/blob/main/airex/vocal/urgency.py): `airex/vocal/urgency.py`

### Reliability and safety

- [Signal fusion](https://github.com/murugavel03/airex-edge-reliability/blob/main/airex/fusion/uncertainty.py): `airex/fusion/uncertainty.py`
- [Decision guardrails](https://github.com/murugavel03/airex-edge-reliability/blob/main/airex/guardrails/decision_manager.py): `airex/guardrails/decision_manager.py`
- [Safety configuration](https://github.com/murugavel03/airex-edge-reliability/blob/main/airex/config.py): `airex/config.py`

### Actions and telemetry

- [Actuator controller](https://github.com/murugavel03/airex-edge-reliability/blob/main/airex/actuator/controller.py): `airex/actuator/controller.py`
- [CSV telemetry](https://github.com/murugavel03/airex-edge-reliability/blob/main/airex/telemetry/logger.py): `airex/telemetry/logger.py`

### Evaluation

- [Evaluation runner](https://github.com/murugavel03/airex-edge-reliability/blob/main/evaluation/run_evaluation.py): `evaluation/run_evaluation.py`
- [Ablation study](https://github.com/murugavel03/airex-edge-reliability/blob/main/evaluation/ablation.py): `evaluation/ablation.py`
- [Figure generation](https://github.com/murugavel03/airex-edge-reliability/blob/main/evaluation/generate_figures.py): `evaluation/generate_figures.py`

### Other components

- **Voice user**
- **Microphone**
- **Camera**
- **Controlled devices**

## Connections

- Voice user → Microphone: speaks into (evidence: `README.md`)
- Microphone → Offline ASR: supplies audio (evidence: `README.md`)
- Camera → Visual presence: provides frames (evidence: `README.md`)
- Pipeline entry → Offline ASR: invokes (evidence: `main.py`)
- Pipeline entry → Intent classifier: invokes (evidence: `main.py`)
- Pipeline entry → Visual presence: conditionally invokes (evidence: `main.py`)
- Pipeline entry → Vocal urgency: conditionally invokes (evidence: `main.py`)
- Pipeline entry → Signal fusion: invokes (evidence: `README.md`)
- Pipeline entry → Decision guardrails: invokes (evidence: `README.md`)
- Pipeline entry → Actuator controller: dispatches decision (evidence: `main.py`)
- Pipeline entry → CSV telemetry: logs outcomes (evidence: `README.md`)
- Pipeline entry → Evaluation runner: runs evaluation mode (evidence: `README.md`)
- Evaluation runner → Ablation study: runs study (evidence: `evaluation/run_evaluation.py`)
- Evaluation runner → Figure generation: generates figures (evidence: `evaluation/run_evaluation.py`)
- Actuator controller → Controlled devices: controls optionally (evidence: `airex/actuator/controller.py`)
- Offline ASR → Safety configuration: reads settings (evidence: `airex/asr/vosk_engine.py`)
- Intent classifier → Safety configuration: reads definitions (evidence: `airex/intent/classifier.py`)
- Visual presence → Safety configuration: reads settings (evidence: `airex/visual/presence.py`)
- Vocal urgency → Safety configuration: reads settings (evidence: `airex/vocal/urgency.py`)
- Signal fusion → Safety configuration: reads weights (evidence: `airex/fusion/uncertainty.py`)
- Decision guardrails → Safety configuration: reads thresholds (evidence: `airex/guardrails/decision_manager.py`)
- Actuator controller → Safety configuration: reads decision type (evidence: `airex/actuator/controller.py`)
- CSV telemetry → Safety configuration: reads settings (evidence: `airex/telemetry/logger.py`)
