| name | run-ego-reconstruction-video |
| description | Run this repository’s egocentric reconstruction pipeline on a video. Use when a user asks to process an MP4 with HaMeR or DynHaMR hand tracking, an object prompt or mesh, undistortion, DROID-SLAM, gravity alignment, gsplat refinement, or a Three.js result export. |
Run Ego Reconstruction Video
Run from reconstruction/. Prefer the consolidated entrypoint and use HaMeR
unless the user explicitly needs legacy DynHaMR:
python modules/v2d_pipelines/run_ego_reconstruction.py \
--video <video.mp4> \
--output_dir data/outputs/<run> \
--object_prompt "<object>" \
--hand_tracking hamer \
--reference_frame 0
Add --object_mesh <mesh.obj> --skip_object_scale_estimation for a supplied
mesh. Add --undistort, --run_droid_slam, --run_gravity_alignment,
--run_gsplat_refinement, and --export_threejs_result only when requested.
Re-run the same command to resume cached stages. Confirm result/result.npz
and result/mesh.obj; with post-processing, use the final suffixed result
directory. Use the setup skill first when images, weights, Docker, or GPU
prerequisites are missing.
