dreamairtracking-dreamair-main-current

DreamAirTracking Dream Air Main Model

Public Dream Air eye-tracking model package for DreamAirTracking.

This package contains the current runtime model pair:

• dreamair-main-current: main gaze / openness / pupil / confidence ONNX model.
• dreamair-expression-current: auxiliary expression ONNX model used by the app for wide/squint outputs.

The app and model are intentionally decoupled. Download this repository's files into:

%LOCALAPPDATA%/DreamAirTracking/models/

The installed folder should contain:

model_registry.json
dreamair-main-current/model.onnx
dreamair-main-current/metadata.json
dreamair-main-current/runtime_defaults.json
dreamair-main-current/acceptance.json
dreamair-expression-current/model.onnx
dreamair-expression-current/metadata.json
dreamair-expression-current/runtime_defaults.json
dreamair-expression-current/acceptance.json

Then start DreamAirTracking and select Dream Air Main.

Validation Snapshot

Acceptance label: round9_geometry_round8_expression_v4
Passed: True
Split used by acceptance script: val

Gaze reach medians from the acceptance report:

This model is tuned for the Dream Air + BrokenEye + DreamAirTracking runtime path. It is not intended as a generic eye-tracking model for other headset layouts.

Dataset Availability

The matching held-out test package is kept private because it contains raw eye-frame images. Public users should use the app's calibration/export workflow and share capture packages manually through a file host when helping improve the model.

Install Layout

Download this repository and copy its contents into:

%LOCALAPPDATA%\DreamAirTracking\models\

After install, these exact files should exist locally:

%LOCALAPPDATA%\DreamAirTracking\models\model_registry.json
%LOCALAPPDATA%\DreamAirTracking\models\sha256.txt

%LOCALAPPDATA%\DreamAirTracking\models\dreamair-main-current\model.onnx
%LOCALAPPDATA%\DreamAirTracking\models\dreamair-main-current\metadata.json
%LOCALAPPDATA%\DreamAirTracking\models\dreamair-main-current\runtime_defaults.json
%LOCALAPPDATA%\DreamAirTracking\models\dreamair-main-current\acceptance.json
%LOCALAPPDATA%\DreamAirTracking\models\dreamair-main-current\model_card.md

%LOCALAPPDATA%\DreamAirTracking\models\dreamair-expression-current\model.onnx
%LOCALAPPDATA%\DreamAirTracking\models\dreamair-expression-current\metadata.json
%LOCALAPPDATA%\DreamAirTracking\models\dreamair-expression-current\runtime_defaults.json
%LOCALAPPDATA%\DreamAirTracking\models\dreamair-expression-current\acceptance.json
%LOCALAPPDATA%\DreamAirTracking\models\dreamair-expression-current\model_card.md

Do not keep the downloaded archive's extra top folder. The app expects model_registry.json directly under %LOCALAPPDATA%\DreamAirTracking\models\.

PowerShell install example:

$modelRoot = Join-Path $env:LOCALAPPDATA "DreamAirTracking\models"
$zip = Join-Path $env:TEMP "dreamairtracking-dreamair-main-current.zip"
$extract = Join-Path $env:TEMP "dreamairtracking-dreamair-main-current"

New-Item -ItemType Directory -Force $modelRoot | Out-Null
Remove-Item -Recurse -Force $extract -ErrorAction SilentlyContinue

Invoke-WebRequest `
  -Uri "https://huggingface.co/Sumirui/dreamairtracking-dreamair-main-current/archive/main.zip" `
  -OutFile $zip

Expand-Archive -Force $zip $extract
$downloadedRoot = Get-ChildItem $extract -Directory | Select-Object -First 1
Copy-Item -Recurse -Force (Join-Path $downloadedRoot.FullName "*") $modelRoot

Quick check:

Test-Path "$env:LOCALAPPDATA\DreamAirTracking\models\model_registry.json"
Test-Path "$env:LOCALAPPDATA\DreamAirTracking\models\dreamair-main-current\model.onnx"
Test-Path "$env:LOCALAPPDATA\DreamAirTracking\models\dreamair-expression-current\model.onnx"

All three commands should print True.