xignage-edge-detection（Overview）

YOLOX による人物検知と、OpenFace ベースの視線推定（将来対応）を組み合わせた Jetson 向けエッジ推論パッケージです。
入力はカメラ/URL、出力は最新結果を1つの JSON にアトミック書き込みします。

• 公開 API：run_camera_loop(camera_id, output_json) / run_inference_once(frame, writers)（__init__.py でエクスポート）
• 推奨環境：Jetson Orin + JetPack（CUDA/TensorRT 対応の PyTorch/TorchVision ホイール）
• ディレクトリ（抜粋）：
  xignage_edge_detection/config/default.yaml … 基本設定
  xignage_edge_detection/pipeline/* … ループ・モデル・Writer
  xignage_edge_detection/detector/* … YOLOX / OpenFace ラッパ
  xignage_edge_detection/io/json_writer.py … JSON Writer（アトミック）
  scripts/run_inference.py … CLI エントリ
  requirements-*.txt / pyproject.toml … 依存

Quick Links

• セットアップ
• 設定
• API
• CLI
• Runtime & Troubleshooting
• CI / GitHub Actions

Note

現状、openface_wrapper.py のモデルは プレースホルダ実装です（視線推定は無効化／None 返却）。