# pulkitpareek18/aeris architecture

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

- Interactive diagram: https://gitdiagram.com/pulkitpareek18/aeris
- Repository: https://github.com/pulkitpareek18/aeris

## Overview

AERIS is a camera-free Wi-Fi CSI sensing research system. Its principal V1 workflow turns public or recorder-captured CSI into prepared model inputs, runs presence inference on a live Raspberry Pi stream, and sends telemetry to a dashboard. The graph also preserves the recorder and dataset-conversion capabilities. Edges are limited to README-documented flows and relationships visible in the supplied excerpts or SOURCE INDEX; dashed edges mark unverified integration details.

Main entry points: [`ml/src/aeris_ml/live_server.py`](https://github.com/pulkitpareek18/aeris/blob/main/ml/src/aeris_ml/live_server.py) (Live inference server), [`ml/src/aeris_ml/schema.py`](https://github.com/pulkitpareek18/aeris/blob/main/ml/src/aeris_ml/schema.py) (CSI record schema), [`aeris-recorder/aeris_recorder_server.py`](https://github.com/pulkitpareek18/aeris/blob/main/aeris-recorder/aeris_recorder_server.py) (Recorder service), [`ml/src/aeris_ml/build_corpus.py`](https://github.com/pulkitpareek18/aeris/blob/main/ml/src/aeris_ml/build_corpus.py) (Corpus builder)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_capture["Capture and recording"]
  node_recorder["Recorder service"]
  node_metadata[("Session metadata<br/>[aeris_db.py]")]
end

subgraph group_datasets["Dataset ingestion"]
  node_pmloader["Presence loader"]
  node_pcaploader["Recorder PCAP loader<br/>[aeris_pcap.py]"]
  node_datasetadapters["Dataset adapters"]
  node_registry["Dataset registry<br/>[registry.py]"]
end

subgraph group_ml["ML preparation and inference"]
  node_schema["CSI record schema<br/>[schema.py]"]
  node_labels["Label mapping<br/>[labels.py]"]
  node_validation["Record validation<br/>[validation.py]"]
  node_preprocessing["Signal preparation<br/>[preprocessing.py]"]
  node_corpus["Corpus builder<br/>[build_corpus.py]"]
  node_training["Model training<br/>[train.py]"]
  node_model["Perception model<br/>[models.py]"]
  node_calibration["Room calibration<br/>[calibrate.py]"]
  node_stream["Nexmon stream decoder<br/>[nexmon_stream.py]"]
  node_adapter["Pi geometry adapter<br/>[pi_adapter.py]"]
  node_live["Live inference server<br/>[live_server.py]"]
end

subgraph group_ui["Live presentation"]
  node_dashboard["Live dashboard<br/>[page.tsx]"]
end

node_researcher(("Researcher"))
node_pi["Raspberry Pi"]
node_publicdata["Public CSI data"]

node_researcher -.->|"records sessions"| node_recorder
node_recorder -->|"stores metadata"| node_metadata
node_pi -.->|"provides capture"| node_recorder
node_publicdata -->|"loads recordings"| node_pmloader
node_recorder -->|"exports sessions"| node_pcaploader
node_publicdata -.->|"loads datasets"| node_datasetadapters
node_registry -.->|"selects adapters"| node_datasetadapters
node_pmloader -.->|"creates records"| node_schema
node_pcaploader -->|"creates records"| node_schema
node_datasetadapters -.->|"creates records"| node_schema
node_schema -->|"uses vocabulary"| node_labels
node_corpus -->|"prepares signals"| node_preprocessing
node_corpus -.->|"loads corpus data"| node_pmloader
node_corpus -.->|"serializes records"| node_schema
node_preprocessing -.->|"validates records"| node_validation
node_training -->|"trains network"| node_model
node_researcher -->|"opens live session"| node_live
node_live -->|"streams CSI"| node_pi
node_live -->|"decodes packets"| node_stream
node_live -->|"adapts geometry"| node_adapter
node_live -->|"runs inference"| node_model
node_live -->|"sends WebSocket data"| node_dashboard
node_researcher -->|"views telemetry"| node_dashboard
node_calibration -->|"calibrates checkpoint"| node_model

click node_recorder "https://github.com/pulkitpareek18/aeris/blob/main/aeris-recorder/aeris_recorder_server.py"
click node_metadata "https://github.com/pulkitpareek18/aeris/blob/main/aeris-recorder/aeris_db.py"
click node_pmloader "https://github.com/pulkitpareek18/aeris/blob/main/ml/src/aeris_ml/datasets/presence_movement.py"
click node_pcaploader "https://github.com/pulkitpareek18/aeris/blob/main/ml/src/aeris_ml/datasets/aeris_pcap.py"
click node_datasetadapters "https://github.com/pulkitpareek18/aeris/tree/main/ml/src/aeris_ml/datasets"
click node_registry "https://github.com/pulkitpareek18/aeris/blob/main/ml/src/aeris_ml/datasets/registry.py"
click node_schema "https://github.com/pulkitpareek18/aeris/blob/main/ml/src/aeris_ml/schema.py"
click node_labels "https://github.com/pulkitpareek18/aeris/blob/main/ml/src/aeris_ml/labels.py"
click node_validation "https://github.com/pulkitpareek18/aeris/blob/main/ml/src/aeris_ml/validation.py"
click node_preprocessing "https://github.com/pulkitpareek18/aeris/blob/main/ml/src/aeris_ml/preprocessing.py"
click node_corpus "https://github.com/pulkitpareek18/aeris/blob/main/ml/src/aeris_ml/build_corpus.py"
click node_training "https://github.com/pulkitpareek18/aeris/blob/main/ml/src/aeris_ml/train.py"
click node_model "https://github.com/pulkitpareek18/aeris/blob/main/ml/src/aeris_ml/models.py"
click node_calibration "https://github.com/pulkitpareek18/aeris/blob/main/ml/src/aeris_ml/calibrate.py"
click node_stream "https://github.com/pulkitpareek18/aeris/blob/main/ml/src/aeris_ml/nexmon_stream.py"
click node_adapter "https://github.com/pulkitpareek18/aeris/blob/main/ml/src/aeris_ml/pi_adapter.py"
click node_live "https://github.com/pulkitpareek18/aeris/blob/main/ml/src/aeris_ml/live_server.py"
click node_dashboard "https://github.com/pulkitpareek18/aeris/blob/main/dashboard/src/app/page.tsx"

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_recorder,node_metadata toneBlue
class node_pmloader,node_pcaploader,node_datasetadapters,node_registry toneAmber
class node_schema,node_labels,node_validation,node_preprocessing,node_corpus,node_training,node_model,node_calibration,node_stream,node_adapter,node_live toneMint
class node_dashboard toneRose
class node_researcher,node_pi,node_publicdata toneIndigo
```

## Components

### Capture and recording

- [Recorder service](https://github.com/pulkitpareek18/aeris/blob/main/aeris-recorder/aeris_recorder_server.py): `aeris-recorder/aeris_recorder_server.py`
- [Session metadata](https://github.com/pulkitpareek18/aeris/blob/main/aeris-recorder/aeris_db.py): `aeris-recorder/aeris_db.py`

### Dataset ingestion

- [Presence loader](https://github.com/pulkitpareek18/aeris/blob/main/ml/src/aeris_ml/datasets/presence_movement.py): `ml/src/aeris_ml/datasets/presence_movement.py`
- [Recorder PCAP loader](https://github.com/pulkitpareek18/aeris/blob/main/ml/src/aeris_ml/datasets/aeris_pcap.py): `ml/src/aeris_ml/datasets/aeris_pcap.py`
- [Dataset adapters](https://github.com/pulkitpareek18/aeris/tree/main/ml/src/aeris_ml/datasets): `ml/src/aeris_ml/datasets`
- [Dataset registry](https://github.com/pulkitpareek18/aeris/blob/main/ml/src/aeris_ml/datasets/registry.py): `ml/src/aeris_ml/datasets/registry.py`

### ML preparation and inference

- [CSI record schema](https://github.com/pulkitpareek18/aeris/blob/main/ml/src/aeris_ml/schema.py): `ml/src/aeris_ml/schema.py`
- [Label mapping](https://github.com/pulkitpareek18/aeris/blob/main/ml/src/aeris_ml/labels.py): `ml/src/aeris_ml/labels.py`
- [Record validation](https://github.com/pulkitpareek18/aeris/blob/main/ml/src/aeris_ml/validation.py): `ml/src/aeris_ml/validation.py`
- [Signal preparation](https://github.com/pulkitpareek18/aeris/blob/main/ml/src/aeris_ml/preprocessing.py): `ml/src/aeris_ml/preprocessing.py`
- [Corpus builder](https://github.com/pulkitpareek18/aeris/blob/main/ml/src/aeris_ml/build_corpus.py): `ml/src/aeris_ml/build_corpus.py`
- [Model training](https://github.com/pulkitpareek18/aeris/blob/main/ml/src/aeris_ml/train.py): `ml/src/aeris_ml/train.py`
- [Perception model](https://github.com/pulkitpareek18/aeris/blob/main/ml/src/aeris_ml/models.py): `ml/src/aeris_ml/models.py`
- [Room calibration](https://github.com/pulkitpareek18/aeris/blob/main/ml/src/aeris_ml/calibrate.py): `ml/src/aeris_ml/calibrate.py`
- [Nexmon stream decoder](https://github.com/pulkitpareek18/aeris/blob/main/ml/src/aeris_ml/nexmon_stream.py): `ml/src/aeris_ml/nexmon_stream.py`
- [Pi geometry adapter](https://github.com/pulkitpareek18/aeris/blob/main/ml/src/aeris_ml/pi_adapter.py): `ml/src/aeris_ml/pi_adapter.py`
- [Live inference server](https://github.com/pulkitpareek18/aeris/blob/main/ml/src/aeris_ml/live_server.py): `ml/src/aeris_ml/live_server.py`

### Live presentation

- [Live dashboard](https://github.com/pulkitpareek18/aeris/blob/main/dashboard/src/app/page.tsx): `dashboard/src/app/page.tsx`

### Other components

- **Researcher**
- **Raspberry Pi**
- **Public CSI data**

## Connections

- Researcher → Recorder service: records sessions
- Recorder service → Session metadata: stores metadata (evidence: `aeris-recorder/aeris_recorder_server.py`)
- Raspberry Pi → Recorder service: provides capture (evidence: `README.md`)
- Public CSI data → Presence loader: loads recordings (evidence: `ml/src/aeris_ml/datasets/presence_movement.py`)
- Recorder service → Recorder PCAP loader: exports sessions (evidence: `ml/src/aeris_ml/datasets/aeris_pcap.py`)
- Public CSI data → Dataset adapters: loads datasets
- Dataset registry → Dataset adapters: selects adapters (evidence: `ml/src/aeris_ml/datasets/__init__.py`)
- Presence loader → CSI record schema: creates records (evidence: `ml/src/aeris_ml/datasets/presence_movement.py`)
- Recorder PCAP loader → CSI record schema: creates records (evidence: `ml/src/aeris_ml/datasets/aeris_pcap.py`)
- Dataset adapters → CSI record schema: creates records (evidence: `ml/src/aeris_ml/datasets/aeris_pcap.py`)
- CSI record schema → Label mapping: uses vocabulary (evidence: `ml/src/aeris_ml/schema.py`)
- Corpus builder → Signal preparation: prepares signals (evidence: `ml/src/aeris_ml/build_corpus.py`)
- Corpus builder → Presence loader: loads corpus data
- Corpus builder → CSI record schema: serializes records
- Signal preparation → Record validation: validates records (evidence: `ml/src/aeris_ml/validation.py`)
- Model training → Perception model: trains network (evidence: `ml/src/aeris_ml/train.py`)
- Researcher → Live inference server: opens live session (evidence: `README.md`)
- Live inference server → Raspberry Pi: streams CSI (evidence: `README.md`)
- Live inference server → Nexmon stream decoder: decodes packets (evidence: `ml/src/aeris_ml/live_server.py`)
- Live inference server → Pi geometry adapter: adapts geometry (evidence: `ml/src/aeris_ml/live_server.py`)
- Live inference server → Perception model: runs inference (evidence: `ml/src/aeris_ml/live_server.py`)
- Live inference server → Live dashboard: sends WebSocket data (evidence: `README.md`)
- Researcher → Live dashboard: views telemetry (evidence: `README.md`)
- Room calibration → Perception model: calibrates checkpoint (evidence: `ml/src/aeris_ml/calibrate.py`)
