How nyarchlinux/nyarchassistant works
Nyarch Assistant is a Linux desktop AI assistant with chat, voice, avatars, tools, document retrieval, and configurable model providers. The main workflow is user input through the application interface to the controller, which runs a model/tool conversation and returns a rich response; optional voice and avatar handling extend that interaction. Other major capabilities include persistent memory, web search, document chat, image generation, scheduled tasks, and remote interfaces. The graph combines documented product capabilities with relationships visible in the supplied excerpts and SOURCE INDEX; unsampled implementation details are not asserted.
Main entry points: controller.py Conversation Controller · window.py Desktop UI · main.py Application Startup · tools.py Tool Registry
Components 23
Application
- Desktop UI
src/window.py - Application Startup
src/main.py - Settings And Profiles
src/ui/settings.py - Scheduled Tasks
src/ui/scheduled_tasks.py
Conversation Runtime
- Conversation Controller
src/controller.py - Context Management
src/utility/context_manager.py - Modes
src/modes.py - Long-Term Memory
src/handlers/memory
AI Capabilities
- Language Models
src/handlers/llm - Image Generation
src/handlers/image_generator
Tools And Retrieval
- Tool Registry
src/tools.py - Extensions
src/extensions.py - Built-in Tools
src/integrations/default_tools.py - Web Search
src/integrations/websearch.py - Website Reading
src/integrations/website_reader.py - Document Retrieval
src/handlers/rag/rag_handler.py
Voice And Interfaces
- Speech Recognition
src/handlers/stt - Speech Synthesis
src/handlers/tts - Translation
src/handlers/translator - Avatar Rendering
src/handlers/avatar - Remote Interfaces
src/handlers/interfaces
Other components
- User
- Model Services
Connections 25
- User → Desktop UI: chats through
README.md - Desktop UI → Application Startup: starts application
src/main.py - Application Startup → Conversation Controller: creates runtime
src/main.py - Application Startup → Desktop UI: opens window
src/main.py - Desktop UI → Conversation Controller: sends interaction
- Settings And Profiles → Conversation Controller: configures
src/ui/settings.py - Scheduled Tasks → Conversation Controller: runs scheduled chats
README.md - Conversation Controller → Language Models: runs model
src/controller.py - Conversation Controller → Tool Registry: dispatches tools
src/controller.py - Conversation Controller → Modes: loads modes
src/controller.py - Conversation Controller → Context Management: trims context
src/controller.py - Conversation Controller → Long-Term Memory: uses memory
src/controller.py - Conversation Controller → Document Retrieval: retrieves documents
src/controller.py - Conversation Controller → Web Search: offers search
src/controller.py - Conversation Controller → Website Reading: reads websites
README.md - Conversation Controller → Image Generation: generates images
src/controller.py - Conversation Controller → Speech Recognition: transcribes speech
src/controller.py - Conversation Controller → Speech Synthesis: speaks response
src/controller.py - Conversation Controller → Translation: translates speech
README.md - Conversation Controller → Avatar Rendering: drives avatar
src/controller.py - Conversation Controller → Extensions: loads extensions
src/controller.py - Extensions → Tool Registry: registers tools
src/extensions.py - Tool Registry → Built-in Tools: exposes built-ins
- Remote Interfaces → Conversation Controller: controls chats
src/handlers/interfaces/gui_api_handler.py - Language Models → Model Services: calls providers