How harpith2/superhuman works
Superhuman is an investigator dashboard that turns uploaded CCTV and suspect notes into parallel visual detections, a searchable movement timeline, geospatial context, and optional public alerts. The main flow is dashboard intake → swarm frame analysis → returned evidence → timeline/map investigation → generated video/news outputs. The graph also preserves documented inpainting and media-publishing capabilities; their detailed wiring is not visible in the sampled source, so those links are intentionally limited.
Components 23
Investigation UI
- Investigator Dashboard
SuperhumanV3/src/app/page.tsx - Business Map
SuperhumanV3/src/components/BusinessMap.tsx - Agent Assignment
SuperhumanV3/src/components/AgentAssignmentModal.tsx
Video Analysis
- Swarm API
SuperhumanV3/src/app/api/agent-swarm/route.ts - Agent Swarm
SuperhumanV3/src/lib/agentSwarm.ts - Timeline Chat
SuperhumanV3/src/app/api/timeline-chat/route.ts - Inpainting Pipeline
SuperhumanV3/video_analyzer.py
Context Services
- Places API
SuperhumanV3/src/app/api/places/route.ts - Video Library API
SuperhumanV3/src/app/api/videos/route.ts - Video Files
SuperhumanV3/public/videos
Alert Generation
- News Script API
SuperhumanV3/src/app/api/generate-news-script/route.ts - Enhanced Video API
SuperhumanV3/src/app/api/enhanced-video/route.ts - Mega Workflow API
SuperhumanV3/src/app/api/mega-workflow/route.ts - Python Media Workflow
SuperhumanV3/mega_workflow.py - Generated Media
SuperhumanV3/src/videosNEW
Other components
- Investigator
- FFmpeg
- Google Maps
- OpenAI
- Runway Gen-4
- Cerebras Vision LLM
- ElevenLabs
- X Platform
Connections 31
- Investigator → Investigator Dashboard: uses
- Investigator Dashboard → Business Map: renders map
- Investigator Dashboard → Places API: requests places
- Places API → Google Maps: geocodes/searches
- Places API → Investigator Dashboard: returns places
- Investigator Dashboard → Agent Assignment: opens assignment
- Agent Assignment → Swarm API: starts swarm
- Swarm API → Agent Swarm: creates/queries
- Agent Swarm → FFmpeg: extracts frames
- Agent Swarm → Cerebras Vision LLM: analyzes frames
- Agent Swarm → Swarm API: returns detections
- Swarm API → Agent Assignment: returns progress
- Investigator Dashboard → Timeline Chat: asks timeline
- Timeline Chat → Cerebras Vision LLM: queries timeline
- Timeline Chat → Investigator Dashboard: returns answer
- Investigator Dashboard → Video Library API: lists videos
- Video Library API → Video Files: reads files
- Video Library API → Investigator Dashboard: returns filenames
- Investigator Dashboard → News Script API: requests script
- News Script API → OpenAI: generates script
- News Script API → Investigator Dashboard: returns script
- Investigator Dashboard → Enhanced Video API: starts enhancement
- Enhanced Video API → Python Media Workflow: spawns workflow
- Mega Workflow API → Python Media Workflow: spawns workflow
- Python Media Workflow → Runway Gen-4: generates video
- Python Media Workflow → Cerebras Vision LLM: generates narration
- Python Media Workflow → ElevenLabs: creates voiceover
- Python Media Workflow → X Platform: posts alert
- Python Media Workflow → Generated Media: writes media
- Enhanced Video API → Investigator Dashboard: reports status
- Mega Workflow API → Investigator Dashboard: returns workflow