How vishnureddy1705/hacknex works
TimeSense AI turns uploaded video into persistent object tracks, semantic events, and a temporal relationship graph; users can inspect the analysis or ask timestamp-grounded questions and seek to supporting video. The documented pipeline establishes the major processing stages, while the source index and excerpts support selected implementation links. Some internals, including detector and tracker behavior and parts of the API orchestration, were not sampled, so uncertain connections are omitted.
Main entry points: App.tsx Dashboard shell · video_processor.py Video processor · questions.py Question API · api.ts REST client
Components 23
Dashboard
- Dashboard shell
frontend/src/App.tsx - REST client
frontend/src/services/api.ts
Video processing
- Video upload API
backend/app/api/videos.py - Video processor
backend/app/services/video_processor.py - Object detection
backend/app/services/detector.py - Identity tracking
backend/app/services/tracker.py - Event detection
backend/app/services/event_detector.py
Temporal Q&A
- Temporal graph
backend/app/services/temporal_engine.py - Question API
backend/app/api/questions.py - Question parser
backend/app/services/question_parser.py - Evidence retrieval
backend/app/services/evidence_retriever.py - Answer generation
backend/app/services/answer_generator.py - Optional VLM
backend/app/services/vlm_service.py - Events API
backend/app/api/events.py - Timestamp utilities
backend/app/utils/timestamps.py
Persistence
- SQLite data store
backend/app/database.py
Playback and views
- Video player
frontend/src/components/VideoPlayer.tsx - Ask video
frontend/src/pages/AskVideoPage.tsx - Event timeline
frontend/src/pages/EventTimelinePage.tsx - Entity browser
frontend/src/pages/EntitiesPage.tsx - Video overview
frontend/src/pages/OverviewPage.tsx - Video analysis
frontend/src/pages/VideoAnalysisPage.tsx
Other components
- Video analyst
Connections 31
- Video analyst → Dashboard shell: uses
- Dashboard shell → REST client: requests data
frontend/src/App.tsx - REST client → Video upload API: uploads video
frontend/src/services/api.ts - Video upload API → Video processor: queues processing
backend/app/api/videos.py - Video processor → Identity tracking: tracks objects
backend/app/services/video_processor.py - Video processor → Event detection: extracts events
backend/app/services/video_processor.py - Video processor → Temporal graph: builds graph
backend/app/services/video_processor.py - Video processor → Object detection: detects objects
- Video processor → SQLite data store: persists analysis
backend/app/services/video_processor.py - Temporal graph → SQLite data store: stores relationships
backend/app/services/temporal_engine.py - Question API → Question parser: parses question
backend/app/api/questions.py - Question API → Evidence retrieval: retrieves evidence
backend/app/api/questions.py - Question API → Answer generation: generates answer
backend/app/api/questions.py - Question API → Optional VLM: optionally verifies
backend/app/api/questions.py - Question API → SQLite data store: records Q&A
backend/app/api/questions.py - Evidence retrieval → SQLite data store: reads evidence
backend/app/services/evidence_retriever.py - Answer generation → Timestamp utilities: formats times
backend/app/services/answer_generator.py - Evidence retrieval → Timestamp utilities: formats evidence times
backend/app/services/evidence_retriever.py - Events API → SQLite data store: reads events
backend/app/api/events.py - Dashboard shell → Ask video: shows Q&A
frontend/src/App.tsx - Dashboard shell → Event timeline: shows timeline
frontend/src/App.tsx - Dashboard shell → Entity browser: shows entities
frontend/src/App.tsx - Dashboard shell → Video overview: shows overview
frontend/src/App.tsx - Dashboard shell → Video analysis: shows analysis
frontend/src/App.tsx - Ask video → REST client: submits question
frontend/src/pages/AskVideoPage.tsx - Ask video → Video player: seeks evidence
frontend/src/pages/AskVideoPage.tsx - Event timeline → Video player: shows playback
frontend/src/pages/EventTimelinePage.tsx - Video analysis → Video player: shows playback
frontend/src/pages/VideoAnalysisPage.tsx - Video overview → REST client: loads video data
frontend/src/pages/OverviewPage.tsx - Video player → REST client: streams video
frontend/src/components/VideoPlayer.tsx - REST client → Question API: asks question
frontend/src/services/api.ts