title	Eyas
emoji	🦅
colorFrom	blue
colorTo	yellow
pinned	true
sdk	gradio
sdk_version	5.38.0
python_version	3.12
app_file	eyas/app.py
license	mit
short_description	AI Security Camera Agent
tags	track:backyard sponsor:openbmb sponsor:nvidia sponsor:openai sponsor:cohere achievement:offgrid achievement:offbrand achievement:llama achievement:sharing achievement:fieldnotes

Eyas: AI Security Camera Agent

	Name	HuggingFace
	Javier Huang	@JavRedstone
	Hanhee Lee	@hanheelee
	Joe Lee	@sehyunlee217

HuggingFace Space · GitHub · Demo Video · Field Notes · Social Media

Eyas is an on-device security camera agent built for our teammate's family's convenience store. It runs person tracking, event detection, and LLM reasoning over CCTV footage to surface theft, loitering, and suspicious activity as a structured, searchable log.

---

What it does

• Visual pipeline — person tracking → VLM observation → event structuring → LLM reasoning
• Event Timeline — scatter chart + table; click any event to seek the annotated video
• Summary & Alerts — risk gauge, flag breakdown, and per-camera narrative
• Ask Footage — natural-language Q&A over the event log via the on-device LLM
• Audio Report — spoken security brief via VoxCPM2 TTS
• Multi-camera — queue multiple clips, get a unified cross-camera session summary
• Korean — full UI and pipeline output translation, hot-swap without restart

Architecture

Models

Model	Role	Size
YOLO11n	Person detector + BotSORT tracker	~6 MB
MiniCPM-V 4.6	Vision-language observer	~1.3B params
Nemotron 3 Nano 4B	LLM reasoner (GGUF Q4)	~2.5 GB
TinyAya Global	Korean translation (GGUF Q4)	~0.5 GB
VoxCPM2	Text-to-speech	~2.4B params

All models download automatically on first run. No API keys required.

---

Docs

Guides

Document	Contents
Setup & Development	Quick start, local dev, Docker, HF Spaces deploy
AI Theft Detection	Capabilities, limits, and best practices
Codex Contributions	Agent-assisted commits, reasoning traces

Architecture

Document	Contents
Architecture	Pipeline diagram, component breakdown, event schema
Off-Brand Frontend	Why and how the UI is a React SPA instead of Gradio components

Models

Document	Contents
YOLO11n	Person detection + BotSORT tracking
MiniCPM-V 4.6	Vision-language observer (VLM)
Nemotron 3 Nano 4B	LLM reasoner — summary, Q&A, alerts
TinyAya Global	Korean translation
VoxCPM2	Text-to-speech audio report

Project

Document	Contents
Field Notes	Build log — design decisions, lessons from each stage, store field test
Submission	Hackathon checklist and what we built
Hackathon	Track info and award categories

Live space: build-small-hackathon/eyas