How abhishek-nadagiri/halomechanics works
HoloMechanix is a webcam-driven 3D engineering learning platform. In the web workflow, a user interacts through the browser; the FastAPI server provides model and learning APIs plus a real-time spatial endpoint, while camera and hand-tracking modules interpret movement and the browser presents the 3D experience. Model metadata and hierarchy underpin component inspection and dismantling; simulation and education provide additional capabilities. A separate desktop mode processes camera frames and renders an OpenCV HUD. The server excerpt omits much of the WebSocket loop, so some runtime links are documented rather than source-verified.
Main entry points: server.py Web API And Stream · main.py Application Entry · gesture_engine.py Gesture Engine · hand_tracker.py Hand Tracking
Components 18
Spatial Perception
- Camera Capture
app/vision/camera.py - Hand Tracking
app/vision/hand_tracker.py - Finger Tracking
app/vision/finger_tracker.py - Gesture Engine
app/vision/gesture_engine.py - Spatial Mapping
app/vision/spatial_mapper.py
Models And Simulation
- Model Metadata
app/models/metadata.py - Model Registry
app/models/registry.py - Assembly Hierarchy
app/models/hierarchy.py - Component State
app/simulation/component.py - Kinematic Simulation
app/simulation/mechanisms.py - Gesture Manipulation
app/interaction/manipulation.py
Engineering Learning
- Learning And Diagnostics
app/education
User Experiences
- Application Entry
app/main.py - Web API And Stream
app/web/server.py - 3D Browser Interface
app/web/static/js - Desktop Renderer
app/rendering/desktop_renderer.py - Desktop HUD
app/ui
Other components
- Engineer Or Learner
Connections 24
- Engineer Or Learner → 3D Browser Interface: interacts with
README.md - 3D Browser Interface → Web API And Stream: streams interaction
README.md - Web API And Stream → 3D Browser Interface: serves static files
app/web/server.py - Application Entry → Web API And Stream: launches web mode
app/main.py - Application Entry → Camera Capture: reads frames
app/main.py - Application Entry → Hand Tracking: tracks hands
app/main.py - Application Entry → Gesture Engine: evaluates gestures
app/main.py - Application Entry → Desktop Renderer: renders desktop
app/main.py - Application Entry → Desktop HUD: uses HUD
app/main.py - Camera Capture → Hand Tracking: provides frames
- Gesture Engine → Hand Tracking: reads landmarks
app/vision/gesture_engine.py - Gesture Engine → Finger Tracking: uses finger tracker
app/vision/gesture_engine.py - Web API And Stream → Camera Capture: captures frames
app/web/server.py - Web API And Stream → Hand Tracking: tracks hands
app/web/server.py - Web API And Stream → Gesture Engine: evaluates gestures
app/web/server.py - Web API And Stream → Spatial Mapping: maps interaction
app/web/server.py - Web API And Stream → Model Registry: serves model data
app/web/server.py - Model Registry → Model Metadata: loads schemas
app/models/registry.py - Assembly Hierarchy → Model Metadata: builds assembly tree
app/models/hierarchy.py - Gesture Manipulation → Assembly Hierarchy: updates dismantling
app/interaction/manipulation.py - Gesture Manipulation → Component State: dispatches gestures
app/interaction/manipulation.py - Web API And Stream → Learning And Diagnostics: serves learning features
app/web/server.py - Web API And Stream → Kinematic Simulation: uses simulation
app/web/server.py - Engineer Or Learner → Application Entry: starts desktop mode
README.md