How qwersyk/newelle works
Newelle is a desktop virtual assistant: users chat through its interface and can extend conversations with model providers, tools, documents, web search, voice, and image generation. The controller is the central orchestration layer, while handler families implement provider-backed capabilities and utilities support context, media, downloads, and local models. The README documents product features; source excerpts and the SOURCE INDEX establish only some implementation relationships, so uncertain links are omitted or marked unverified.
Main entry points: controller.py Conversation controller · tools.py Tools and skills · utility Runtime utilities · window.py Desktop interface
Components 19
Application
- Application startup
src/main.py - Desktop interface
src/window.py - Conversation controller
src/controller.py - External interfaces
src/handlers/interfaces - Modes and profiles
src/modes.py
AI and content
- Language models
src/handlers/llm - Speech input/output
src/handlers/stt - Image generation
src/handlers/image_generator - Document retrieval
src/handlers/rag/rag_handler.py - Conversation memory
src/handlers/memory - Web search
src/handlers/websearch
Tools and integrations
- Tools and skills
src/tools.py - Integration features
src/integrations - Extensions
src/extensions.py
Runtime support
- Context management
src/utility/context_manager.py - Runtime utilities
src/utility - Download registry
src/utility/download_manager.py - Local model library
src/ui/model_library.py
Other components
- User
Connections 19
- User → Desktop interface: chats through
- Application startup → Conversation controller: initializes
src/main.py - Desktop interface → Conversation controller: submits chat
- Conversation controller → Language models: selects handlers
src/controller.py - Conversation controller → Document retrieval: builds and queries
src/controller.py - Conversation controller → Context management: manages context
src/controller.py - Conversation controller → Conversation memory: uses memory
src/controller.py - Conversation controller → Tools and skills: updates tools
src/controller.py - Conversation controller → Web search: selects handlers
src/controller.py - Conversation controller → Image generation: selects handlers
src/controller.py - Conversation controller → Speech input/output: supports voice
src/controller.py - Conversation controller → Modes and profiles: loads modes
src/controller.py - External interfaces → Conversation controller: routes API requests
src/controller.py - Integration features → Tools and skills: provides tools
src/integrations/websearch.py - Extensions → Tools and skills: extends capabilities
- Local model library → Download registry: tracks transfers
src/ui/model_library.py - Language models → Runtime utilities: uses runtime support
src/handlers/llm/llama_cpp_handler.py - Speech input/output → Runtime utilities: uses runtime support
src/handlers/stt/whispercpp_handler.py - Image generation → Runtime utilities: uses runtime support
src/handlers/image_generator/stablediffusion_cpp_handler.py