| name | SmartHome Video Anomaly Benchmark |
| description | VLM evaluation suite for video anomaly detection in smart home camera footage |
| version | 1.0.0 |
| category | analysis |
| runtime | node |
| entry | scripts/run-benchmark.cjs |
| install | npm |
| requirements | {"node":">=18","npm_install":true,"system_deps":["yt-dlp","ffmpeg"],"platforms":["linux","macos","windows"]} |
SmartHome Video Anomaly Benchmark
Benchmark suite evaluating VLM models on video anomaly detection across 7 smart home categories — based on the SmartHome-Bench dataset (1,203 YouTube smart home camera clips).
Key differentiator from HomeSec-Bench: This benchmark requires video understanding (multi-frame sampling), not single-frame analysis.
Setup
Requires npm install + system dependencies. The deployment agent should:
- Check for
yt-dlp and ffmpeg in PATH
- Run
npm install in the skill directory
Entry script: scripts/run-benchmark.cjs
Verification
node scripts/run-benchmark.cjs --help
Quick Start
As an Aegis Skill (automatic)
When spawned by Aegis, configuration is injected via environment variables. The benchmark downloads video clips, samples frames, evaluates with VLM, and generates an HTML report.
Standalone
node scripts/run-benchmark.cjs --vlm http://localhost:5405
node scripts/run-benchmark.cjs --vlm http://localhost:5405 --max-videos 10
node scripts/run-benchmark.cjs --vlm http://localhost:5405 --mode full
node scripts/run-benchmark.cjs --vlm http://localhost:5405 --categories "Wildlife,Security"
node scripts/run-benchmark.cjs --vlm http://localhost:5405 --skip-download
node scripts/run-benchmark.cjs --vlm http://localhost:5405 --no-open
Configuration
Environment Variables (set by Aegis)
| Variable | Default | Description |
|---|
AEGIS_VLM_URL | (required) | VLM server base URL |
AEGIS_VLM_MODEL | — | Loaded VLM model ID |
AEGIS_SKILL_ID | — | Skill identifier (enables skill mode) |
AEGIS_SKILL_PARAMS | {} | JSON params from skill config |
Note: This is a VLM-only benchmark. An LLM gateway is not required.
User Configuration (config.yaml)
This skill includes a config.yaml that defines user-configurable parameters. Aegis parses this at install time and renders a config panel in the UI. Values are delivered via AEGIS_SKILL_PARAMS.
| Parameter | Type | Default | Description |
|---|
mode | select | subset | Which clips to evaluate: subset (~50 clips) or full (all ~105 curated clips) |
maxVideos | number | 50 | Maximum number of videos to evaluate |
categories | text | all | Comma-separated category filter (e.g. Wildlife,Security) |
noOpen | boolean | false | Skip auto-opening the HTML report in browser |
CLI Arguments (standalone fallback)
| Argument | Default | Description |
|---|
--vlm URL | (required) | VLM server base URL |
--out DIR | ~/.aegis-ai/smarthome-bench | Results directory |
--max-videos N | 50 | Max videos to evaluate |
--mode MODE | subset | subset or full |
--categories LIST | all | Comma-separated category filter |
--skip-download | — | Skip video download, use cached |
--no-open | — | Don't auto-open report in browser |
--report | (auto in skill mode) | Force report generation |
Protocol
Aegis → Skill (env vars)
AEGIS_VLM_URL=http://localhost:5405
AEGIS_SKILL_ID=smarthome-bench
AEGIS_SKILL_PARAMS={}
Skill → Aegis (stdout, JSON lines)
{"event": "ready", "model": "SmolVLM2-2.2B", "system": "Apple M3"}
{"event": "suite_start", "suite": "Wildlife"}
{"event": "test_result", "suite": "Wildlife", "test": "smartbench_0003", "status": "pass", "timeMs": 4500}
{"event": "suite_end", "suite": "Wildlife", "passed": 12, "failed": 3}
{"event": "complete", "passed": 78, "total": 105, "timeMs": 480000, "reportPath": "/path/to/report.html"}
Human-readable output goes to stderr (visible in Aegis console tab).
Test Suites (7 Categories)
| Suite | Description | Anomaly Examples |
|---|
| 🦊 Wildlife | Wild animals near home cameras | Bear on porch, deer in garden, coyote at night |
| 👴 Senior Care | Elderly activity monitoring | Falls, wandering, unusual inactivity |
| 👶 Baby Monitoring | Infant/child safety | Stroller rolling, child climbing, unsupervised |
| 🐾 Pet Monitoring | Pet behavior detection | Pet illness, escaped pets, unusual behavior |
| 🔒 Home Security | Intrusion & suspicious activity | Break-ins, trespassing, porch pirates |
| 📦 Package Delivery | Package arrival & theft | Stolen packages, misdelivered, weather damage |
| 🏠 General Activity | General smart home events | Unusual hours activity, appliance issues |
Each clip is evaluated for binary anomaly detection: the VLM predicts normal (0) or abnormal (1), compared against expert annotations.
Metrics
Per-category and overall:
- Accuracy — correct predictions / total
- Precision — true positives / predicted positives
- Recall — true positives / actual positives
- F1-Score — harmonic mean of precision & recall
- Confusion Matrix — TP, FP, TN, FN breakdown
Results
Results are saved to ~/.aegis-ai/smarthome-bench/ as JSON. An HTML report with per-category breakdown, confusion matrix, and model comparison is auto-generated.
Requirements
- Node.js ≥ 18
npm install (for openai SDK dependency)yt-dlp (video download from YouTube)ffmpeg (frame extraction from video clips)- Running VLM server (must support multi-image input)
Citation
Based on SmartHome-Bench: A Comprehensive Benchmark for Video Anomaly Detection in Smart Homes Using Multi-Modal Foundation Models.
