# muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi architecture

> Architecture diagram of the GitHub repository muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi
- Repository: https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi

## Overview

MuratJARVIS is a Gemini Live-based desktop assistant with a PyQt6 interface, voice sessions, multi-brain reasoning, local user data, computer and web tools, and an optional dashboard. The main user flow starts at the UI or voice session, passes requests through the live backend and tool/security dispatch, then returns a response; persistent memory and local services support that work. The README documents these capabilities, while several large modules were not sampled, so links for those branches are limited to documented relationships or omitted where runtime wiring is unclear.

Main entry points: [`src/jarvis/main.py`](https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/src/jarvis/main.py) (Gemini Live Session), [`tools/registry.py`](https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/tools/registry.py) (Tool Registry), [`src/jarvis/core/brain_orchestrator.py`](https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/src/jarvis/core/brain_orchestrator.py) (Brain Orchestrator), [`src/jarvis/self_improvement/virtual_brain/orchestrator/experiment_manager.py`](https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/src/jarvis/self_improvement/virtual_brain/orchestrator/experiment_manager.py) (Virtual Brain Experiments)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["User Interface"]
  node_ui["PyQt6 Interface<br/>[ui.py]"]
end

subgraph group_runtime["Assistant Runtime"]
  node_entry["Application Entry<br/>[main.py]"]
  node_live["Gemini Live Session<br/>[main.py]"]
  node_brains["Brain Orchestrator"]
  node_llm["LLM Client<br/>[llm_client.py]"]
  node_context["Session Context<br/>[context_engine.py]"]
end

subgraph group_tools["Tools And Actions"]
  node_registry["Tool Registry<br/>[registry.py]"]
  node_gate["Tool Gate<br/>[tool_gate.py]"]
  node_intent["Intent Router<br/>[intent_router.py]"]
  node_files["File Operations<br/>[file_controller.py]"]
  node_devagent["Developer Agent<br/>[dev_agent.py]"]
  node_web["Web And Research<br/>[web_search.py]"]
  node_desktop["Desktop Controls<br/>[desktop.py]"]
  node_computer["Computer Controls"]
end

subgraph group_state["Local State And Security"]
  node_memory[("Persistent Memory<br/>[memory_manager.py]")]
  node_paths["User Data Paths<br/>[paths.py]"]
  node_config["Secure Configuration<br/>[secure_config.py]"]
  node_security["Tool Security<br/>[security.py]"]
  node_approval["Action Approval"]
  node_tasks[("Task Manager<br/>[task_manager.py]")]
  node_embedding["Embedding Provider"]
end

subgraph group_extensions["Optional Services"]
  node_dashboard["Local Dashboard<br/>[server.py]"]
  node_experiment["Virtual Brain Experiments"]
end

node_user(("User"))
node_external{{"Gemini Service"}}

node_user -->|"interacts"| node_ui
node_ui -->|"starts backend"| node_entry
node_entry -->|"creates session"| node_live
node_live -.->|"streams conversation"| node_external
node_live -->|"checks tool call"| node_gate
node_live -->|"dispatches tools"| node_registry
node_live -.->|"delegates reasoning"| node_brains
node_brains -.->|"requests completions"| node_llm
node_live -.->|"maintains context"| node_context
node_live -->|"loads memory"| node_memory
node_registry -->|"checks permission"| node_security
node_registry -.->|"dispatches intent"| node_intent
node_intent -->|"routes file actions"| node_files
node_registry -.->|"dispatches coding"| node_devagent
node_registry -.->|"dispatches research"| node_web
node_registry -.->|"dispatches desktop"| node_desktop
node_registry -.->|"dispatches controls"| node_computer
node_live -.->|"requests confirmation"| node_approval
node_live -.->|"manages tasks"| node_tasks
node_memory -->|"stores under"| node_paths
node_config -->|"resolves data directory"| node_paths
node_dashboard -->|"loads TLS settings"| node_config
node_experiment -->|"runs research steps"| node_brains
node_experiment -.->|"persists experiments"| node_tasks
node_embedding -.->|"uses local model option"| node_external

click node_ui "https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/src/jarvis/ui.py"
click node_entry "https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/src/jarvis/main.py"
click node_live "https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/src/jarvis/main.py"
click node_brains "https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/src/jarvis/core/brain_orchestrator.py"
click node_llm "https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/src/jarvis/core/llm_client.py"
click node_context "https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/src/jarvis/core/context_engine.py"
click node_registry "https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/tools/registry.py"
click node_gate "https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/src/jarvis/tool_gate.py"
click node_intent "https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/src/jarvis/actions/intent_router.py"
click node_files "https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/src/jarvis/actions/file_controller.py"
click node_devagent "https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/src/jarvis/actions/dev_agent.py"
click node_web "https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/src/jarvis/actions/web_search.py"
click node_desktop "https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/src/jarvis/actions/desktop.py"
click node_computer "https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/src/jarvis/actions/computer_control.py"
click node_memory "https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/src/jarvis/memory/memory_manager.py"
click node_paths "https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/src/jarvis/paths.py"
click node_config "https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/src/jarvis/core/secure_config.py"
click node_security "https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/tools/security.py"
click node_approval "https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/src/jarvis/core/approval_service.py"
click node_tasks "https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/src/jarvis/core/task_manager.py"
click node_dashboard "https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/src/jarvis/dashboard/server.py"
click node_experiment "https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/src/jarvis/self_improvement/virtual_brain/orchestrator/experiment_manager.py"
click node_embedding "https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/memory/embedding_provider.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_ui,node_user toneBlue
class node_entry,node_live,node_brains,node_llm,node_context toneAmber
class node_registry,node_gate,node_intent,node_files,node_devagent,node_web,node_desktop,node_computer toneMint
class node_memory,node_paths,node_config,node_security,node_approval,node_tasks,node_embedding toneRose
class node_dashboard,node_experiment,node_external toneIndigo
```

## Components

### User Interface

- [PyQt6 Interface](https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/src/jarvis/ui.py): `src/jarvis/ui.py`

### Assistant Runtime

- [Application Entry](https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/src/jarvis/main.py): `src/jarvis/main.py`
- [Gemini Live Session](https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/src/jarvis/main.py): `src/jarvis/main.py`
- [Brain Orchestrator](https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/src/jarvis/core/brain_orchestrator.py): `src/jarvis/core/brain_orchestrator.py`
- [LLM Client](https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/src/jarvis/core/llm_client.py): `src/jarvis/core/llm_client.py`
- [Session Context](https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/src/jarvis/core/context_engine.py): `src/jarvis/core/context_engine.py`

### Tools And Actions

- [Tool Registry](https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/tools/registry.py): `tools/registry.py`
- [Tool Gate](https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/src/jarvis/tool_gate.py): `src/jarvis/tool_gate.py`
- [Intent Router](https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/src/jarvis/actions/intent_router.py): `src/jarvis/actions/intent_router.py`
- [File Operations](https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/src/jarvis/actions/file_controller.py): `src/jarvis/actions/file_controller.py`
- [Developer Agent](https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/src/jarvis/actions/dev_agent.py): `src/jarvis/actions/dev_agent.py`
- [Web And Research](https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/src/jarvis/actions/web_search.py): `src/jarvis/actions/web_search.py`
- [Desktop Controls](https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/src/jarvis/actions/desktop.py): `src/jarvis/actions/desktop.py`
- [Computer Controls](https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/src/jarvis/actions/computer_control.py): `src/jarvis/actions/computer_control.py`

### Local State And Security

- [Persistent Memory](https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/src/jarvis/memory/memory_manager.py): `src/jarvis/memory/memory_manager.py`
- [User Data Paths](https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/src/jarvis/paths.py): `src/jarvis/paths.py`
- [Secure Configuration](https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/src/jarvis/core/secure_config.py): `src/jarvis/core/secure_config.py`
- [Tool Security](https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/tools/security.py): `tools/security.py`
- [Action Approval](https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/src/jarvis/core/approval_service.py): `src/jarvis/core/approval_service.py`
- [Task Manager](https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/src/jarvis/core/task_manager.py): `src/jarvis/core/task_manager.py`
- [Embedding Provider](https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/memory/embedding_provider.py): `memory/embedding_provider.py`

### Optional Services

- [Local Dashboard](https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/src/jarvis/dashboard/server.py): `src/jarvis/dashboard/server.py`
- [Virtual Brain Experiments](https://github.com/muratuzpek-tech/jarvis-sesli-asistan-ve-g-venli-otomatik-g-ncelleme-sistemi/blob/main/src/jarvis/self_improvement/virtual_brain/orchestrator/experiment_manager.py): `src/jarvis/self_improvement/virtual_brain/orchestrator/experiment_manager.py`

### Other components

- **User**
- **Gemini Service**

## Connections

- User → PyQt6 Interface: interacts (evidence: `README.md`)
- PyQt6 Interface → Application Entry: starts backend (evidence: `src/jarvis/main.py`)
- Application Entry → Gemini Live Session: creates session (evidence: `src/jarvis/main.py`)
- Gemini Live Session → Gemini Service: streams conversation (evidence: `README.md`)
- Gemini Live Session → Tool Gate: checks tool call (evidence: `src/jarvis/main.py`)
- Gemini Live Session → Tool Registry: dispatches tools (evidence: `src/jarvis/main.py`)
- Gemini Live Session → Brain Orchestrator: delegates reasoning
- Brain Orchestrator → LLM Client: requests completions
- Gemini Live Session → Session Context: maintains context
- Gemini Live Session → Persistent Memory: loads memory (evidence: `src/jarvis/main.py`)
- Tool Registry → Tool Security: checks permission (evidence: `tools/registry.py`)
- Tool Registry → Intent Router: dispatches intent
- Intent Router → File Operations: routes file actions (evidence: `src/jarvis/actions/intent_router.py`)
- Tool Registry → Developer Agent: dispatches coding
- Tool Registry → Web And Research: dispatches research
- Tool Registry → Desktop Controls: dispatches desktop
- Tool Registry → Computer Controls: dispatches controls
- Gemini Live Session → Action Approval: requests confirmation (evidence: `src/jarvis/main.py`)
- Gemini Live Session → Task Manager: manages tasks
- Persistent Memory → User Data Paths: stores under (evidence: `src/jarvis/memory/memory_manager.py`)
- Secure Configuration → User Data Paths: resolves data directory (evidence: `src/jarvis/core/secure_config.py`)
- Local Dashboard → Secure Configuration: loads TLS settings (evidence: `src/jarvis/dashboard/server.py`)
- Virtual Brain Experiments → Brain Orchestrator: runs research steps (evidence: `src/jarvis/self_improvement/virtual_brain/orchestrator/experiment_manager.py`)
- Virtual Brain Experiments → Task Manager: persists experiments
- Embedding Provider → Gemini Service: uses local model option
