How shiv0xparanoid/holopad works
Holopad is a web-based spatial-creation prototype. Its main user flow is image upload, AI-assisted segmentation and 3D-model generation, then interactive viewing and editing with optional hand tracking and export. The repository also includes a separate assistant, memory, and marketplace/token API, plus marketing and showcase experiences. Several screens and backend modules were not excerpted, so their documented capabilities are represented at subsystem level; unverified connections are omitted or marked dashed.
Main entry points: index.js Backend API · App.jsx App Router · Viewer.jsx Hologram Viewer · ai_service.js AI Assistant
Components 20
Spatial Web App
- App Router
web/src/App.jsx - Image Upload
web/src/screens/Upload.jsx - Hologram Viewer
web/src/screens/Viewer.jsx - 3D Engine
web/src/utils/HologramEngine.js - Hand Tracking
web/src/utils/HandController.js - Holostage
web/src/screens/HolostagePage.jsx - Marketing Pages
web/src/pages/WebsiteHome.jsx - Spatial Audio
web/src/utils/SoundManager.js
Image Creation
- Backend API
server/src/index.js - GLB Processing
server/src/process_image_to_glb.js - SAM Client
server/src/sam_client.js - SAM Service
server/python/sam_service.py - Image Analysis
server/src/meg.js
Assistant Services
- Persona API
server/src/persona.js - AI Assistant
server/src/ai_service.js - Conversation Memory
server/src/memory.js
Platform Services
- Database
server/src/db.js - Marketplace
server/src/index.js
Other components
- Creator
- Ollama
Connections 22
- Creator → App Router: opens
- App Router → Image Upload: routes to
web/src/App.jsx - App Router → Hologram Viewer: routes to
web/src/App.jsx - App Router → Holostage: routes to
web/src/App.jsx - App Router → Marketing Pages: routes to
web/src/App.jsx - Image Upload → Backend API: submits image
- Backend API → SAM Client: requests segmentation
server/src/index.js - Backend API → GLB Processing: creates model
server/src/index.js - SAM Client → SAM Service: sends image
server/src/sam_client.js - GLB Processing → SAM Client: requests segmentation
server/src/process_image_to_glb.js - Backend API → Image Analysis: requests image analysis
server/src/index.js - Backend API → Hologram Viewer: serves model URL
- Hologram Viewer → 3D Engine: initializes renderer
web/src/screens/Viewer.jsx - 3D Engine → Hand Tracking: initializes tracking
web/src/utils/HologramEngine.js - Hologram Viewer → Spatial Audio: uses audio
web/src/screens/Viewer.jsx - Hologram Viewer → Backend API: calls chat API
web/src/screens/Viewer.jsx - Backend API → Persona API: mounts routes
server/src/index.js - Persona API → AI Assistant: delegates assistant work
server/src/persona.js - AI Assistant → Conversation Memory: searches and records
server/src/ai_service.js - AI Assistant → Ollama: generates responses
server/src/ai_service.js - Backend API → Database: connects and stores
server/src/index.js - Creator → Marketplace: browses and lists models
server/src/index.js