How naman-dua/kora works
Kora is a local-first Windows assistant whose main interaction loop accepts text or speech, routes commands, and returns a UI or spoken response. Specialized workflows cover local-LLM conversation and memory, screen vision, reminders and briefings, document ingestion, web information, and OS actions/plugins. The excerpts show command dispatch, scheduling persistence, and document storage; several README capabilities have only tree-level evidence, so their internal wiring is not expanded. Optional network services are shown separately from local functionality.
Main entry points: kora_operator.py Command Operator · main.py Assistant Runtime · storage.py Memory Store · actions.py OS Actions
Components 24
Assistant Interaction
- Dashboard UI
gui.py - Voice I/O
voice.py - Assistant Runtime
main.py - Command Operator
kora_operator.py
Intelligence and Memory
- Local LLM Brain
brain.py - Memory Tools
memory_tools.py - Fact Memory
nlp_memory.py - Document Ingestion
ingest_docs.py
Vision and Scheduling
- Screen Analysis
screen_analysis.py - Live Eye
live_eye.py - Reminders and Tasks
tasks.py - Morning Briefing
morning_briefing.py
Tools and Integrations
- OS Actions
actions.py - File Operations
file_ops.py - Window Control
window_mgmt.py - Media Control
media_control.py - Plugin System
plugin_loader.py - Web Search
search_engine.py - Weather
weather.py - News Feed
news_feed.py
Persistent State
- Memory Store
storage.py
Other components
- User
- Ollama
- Web Services
Connections 28
- User → Dashboard UI: enters text
- User → Voice I/O: speaks
- Dashboard UI → Assistant Runtime: submits text
- Voice I/O → Assistant Runtime: provides speech
- Assistant Runtime → Voice I/O: speaks reply
- Assistant Runtime → Command Operator: dispatches command
- Assistant Runtime → Reminders and Tasks: checks tasks
- Command Operator → OS Actions: executes plan
- Command Operator → Web Search: runs search
- Command Operator → Screen Analysis: analyzes screen
- Command Operator → Reminders and Tasks: handles task memory
- Command Operator → Memory Store: reads automations
- Reminders and Tasks → Memory Store: persists schedule
- Document Ingestion → Memory Store: stores chunks
- Local LLM Brain → Ollama: queries model
- Memory Tools → Memory Store: reads and writes
- Fact Memory → Memory Store: stores facts
- Live Eye → Screen Analysis: monitors screen
- OS Actions → File Operations: uses file tools
- OS Actions → Window Control: uses window tools
- OS Actions → Media Control: uses media tools
- Plugin System → Web Services: loads plugins
- Web Search → Web Services: queries web
- Weather → Web Services: fetches forecast
- News Feed → Web Services: fetches news
- Morning Briefing → Weather: includes weather
- Morning Briefing → News Feed: includes news
- Morning Briefing → Reminders and Tasks: includes todos