How damirasainov/aikoru works
AIKORU is an offline Russian/Kazakh spatial-awareness assistant for blind and low-vision users. Its main workflow captures camera frames, detects and tracks objects, interprets scene changes, and speaks useful alerts; users can also issue voice commands to describe a scene, find an object, or manage familiar faces. The web interface exposes video, events, command entry, and face controls. The graph follows the README and shown source references; some internal orchestration details are unsampled, so only documented or indexed relationships are shown.
Main entry points: assistant.py Assistant orchestrator · web.py Web server and API · tts.py Prioritized speech output · camera.py Frame capture
Components 20
Application control
- Runtime entry
aikoru/__main__.py - Configuration
aikoru/config.py - Assistant orchestrator
aikoru/assistant.py
Camera perception
- Frame capture
aikoru/camera.py - Object detection and tracking
aikoru/detector.py - Scene and track state
aikoru/scene.py - Familiar face recognition
aikoru/faces.py
Voice and commands
- Wake word and speech input
aikoru/voice.py - Command interpretation
aikoru/commands.py - Bilingual lexicon and phrases
aikoru/lexicon.py
Assistant responses
- NLLB translation
aikoru/translator.py - Scene description and questions
aikoru/vlm.py - Prioritized speech output
aikoru/tts.py
Web interface
- Web server and API
aikoru/web.py - Web interface
aikoru/web/app.js
Other components
- User
- Microphone
- Headphones
- Browser
- USB camera
Connections 24
- User → Microphone: speaks commands
README.md - Microphone → Wake word and speech input: provides audio
README.md - Wake word and speech input → Assistant orchestrator: delivers command
README.md - Assistant orchestrator → Command interpretation: parses command
aikoru/assistant.py - Command interpretation → Bilingual lexicon and phrases: looks up objects
aikoru/commands.py - Assistant orchestrator → Configuration: loads settings
aikoru/__main__.py - Runtime entry → Assistant orchestrator: starts runtime
aikoru/__main__.py - USB camera → Frame capture: supplies frames
README.md - Assistant orchestrator → Frame capture: reads frames
README.md - Assistant orchestrator → Object detection and tracking: scans frames
README.md - Object detection and tracking → Scene and track state: provides tracked detections
aikoru/scene.py - Assistant orchestrator → Scene and track state: updates scene
README.md - Assistant orchestrator → Familiar face recognition: identifies familiar people
README.md - Assistant orchestrator → NLLB translation: translates object queries
README.md - Assistant orchestrator → Scene description and questions: requests scene description
README.md - Assistant orchestrator → Prioritized speech output: queues spoken response
README.md - Prioritized speech output → Bilingual lexicon and phrases: formats speech
aikoru/tts.py - Prioritized speech output → Headphones: plays speech
README.md - Assistant orchestrator → Web server and API: starts interface
aikoru/assistant.py - Web server and API → Frame capture: serves camera frames
aikoru/web.py - Web server and API → Assistant orchestrator: routes commands and controls
aikoru/web.py - Web server and API → Web interface: serves interface assets
README.md - Browser → Web server and API: requests interface and API
README.md - Web interface → Browser: renders controls and events
README.md