How jakerains/hci-v3 works
Main Components
A. Frontend Layer:
• Next.js Application (Port 3000)
• Main Interface Components
• NavalHelmInterface
• CompassDisplay
• ShipStatus
• CommandLog
• Theme System
• Voice Command UI
B. Backend Services:
• WebSocket Server (Port 2700)
• Vosk Voice Recognition
• API Routes
• Voice Recognition
• Text-to-Speech
• Command Processing
• Theme Management
C. External Services:
• Google Gemini AI
• ElevenLabs Text-to-Speech
• Vosk Speech Recognition Models
Component Relationships
User Input Layer
↓
Frontend Components ←→ Context Providers (Theme)
↓
API Layer
↓
External Services Layer
Specific Implementation Details
a) User Interface Layer (Blue):
• Voice Input Component
• Visual Components
• Command History
• Settings Management
b) Application Core (Green):
• Custom Hooks
• useVoiceCommands
• useAudioFeedback
• useVoiceRecognition
• Context Providers
• Command Processing
c) Backend Services (Orange):
• Voice Recognition API
• Text-to-Speech API
• Command Processing API
• WebSocket Server
d) External Services (Purple):
• Google Gemini
• ElevenLabs
• Vosk Model Storage
Technical Stack Indicators
Technology badges for:
• Next.js 13.5
• TypeScript
• Tailwind CSS
• WebSocket
• Vosk
• External APIs
Important Architectural Notes
• Offline capabilities
• API key management flow
• Real-time update paths
• Theme switching system
• Model download/management system