How saksham-garg2008/desk works
DESK is a native desktop AI-office app: users create or configure agents, select a model backend, chat with agents, and retain conversation history and distilled memory. Agent responses can become versioned workspace artifacts, which users browse and inspect. The graph emphasizes these domain stages and the UI/runtime orchestration. Most links are supported by README statements or indexed imports; unsampled UI and peripheral modules are represented only where documented, so some detailed runtime wiring is omitted.
Main entry points: chat_panel.py Agent chat · main_window.py Main window · inference_manager.py Inference gateway · artifact_manager.py Artifact manager
Components 21
Desktop experience
- Main window
ui/main_window.py - Agent chat
ui/panels/chat_panel.py - Workspace browser
ui/panels/workspace_panel.py - Code inspector
ui/panels/code_inspector_panel.py - Memory panel
ui/panels/memory_panel.py
Agent management
- Create agent
ui/dialogs/add_agent_dialog.py - Edit agent
ui/dialogs/edit_agent_dialog.py - Agent prompts
bucket
Conversation runtime
- Compute manager
core/compute_manager.py - Inference gateway
core/inference_manager.py
Persistent workspace
- Chat history
core/history_manager.py - Long-term memory
core/memory_manager.py - Artifact manager
core/artifact_manager.py - Versioned artifacts
workspace
Configuration
- Agent configuration
config/agents.json - Config loader
core/config_loader.py - App and model settings
config - Data paths
core/paths.py - API keys
ui/panels/keys_panel.py
Other components
- Desktop user
- LLM providers
Connections 30
- Desktop user → Main window: uses
README.md - Main window → Agent chat: shows
ui/main_window.py - Main window → Workspace browser: opens
ui/main_window.py - Main window → Code inspector: opens
ui/main_window.py - Main window → Memory panel: shows
ui/main_window.py - Desktop user → Create agent: creates
README.md - Create agent → Agent configuration: configures
ui/dialogs/add_agent_dialog.py - Create agent → Agent prompts: writes prompt
README.md - Desktop user → Edit agent: edits
README.md - Edit agent → Agent configuration: updates
ui/dialogs/edit_agent_dialog.py - Edit agent → Agent prompts: updates prompt
ui/dialogs/edit_agent_dialog.py - Agent chat → Compute manager: dispatches
ui/panels/chat_panel.py - Compute manager → Inference gateway: runs worker
core/compute_manager.py - Inference gateway → LLM providers: streams requests
README.md - Agent chat → Chat history: saves chat
ui/panels/chat_panel.py - Agent chat → Artifact manager: parses response
ui/panels/chat_panel.py - Artifact manager → Versioned artifacts: persists versions
README.md - Workspace browser → Artifact manager: lists files
ui/panels/workspace_panel.py - Code inspector → Artifact manager: reads versions
ui/panels/code_inspector_panel.py - Agent chat → Long-term memory: distills exchanges
ui/panels/chat_panel.py - Memory panel → Long-term memory: views and edits
ui/panels/memory_panel.py - Memory panel → Inference gateway: regenerates memory
ui/panels/memory_panel.py - Config loader → App and model settings: reads and writes
core/config_loader.py - Config loader → Data paths: uses paths
core/config_loader.py - API keys → Config loader: stores keys
ui/panels/keys_panel.py - Inference gateway → Config loader: loads provider config
core/inference_manager.py - Chat history → Data paths: uses paths
core/history_manager.py - Long-term memory → Data paths: uses paths
core/memory_manager.py - Artifact manager → Data paths: uses paths
core/artifact_manager.py - Agent chat → Inference gateway: requests response
ui/panels/chat_panel.py