# kosmo471/agan-browser architecture

> Architecture diagram of the GitHub repository kosmo471/agan-browser, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kosmo471/agan-browser
- Repository: https://github.com/kosmo471/agan-browser

## Overview

AğanBrowser is a Windows desktop browser built on WebView2, with a local Ollama assistant and privacy-focused browsing features. The main workflow is navigating pages in tabs, with MainWindow coordinating browser events and handing work to feature services. The graph also preserves documented capabilities whose implementations were not sampled. Edges are limited to calls visible in excerpts or relationships stated in the README; some feature internals remain unsampled.

Main entry points: [`MainWindow.xaml.cs`](https://github.com/kosmo471/agan-browser/blob/main/MainWindow.xaml.cs) (Window & Tabs), [`Services/OllamaService.cs`](https://github.com/kosmo471/agan-browser/blob/main/Services/OllamaService.cs) (Ollama Client), [`Services/ExtensionService.cs`](https://github.com/kosmo471/agan-browser/blob/main/Services/ExtensionService.cs) (Browser Extensions), [`Services/ThemeService.cs`](https://github.com/kosmo471/agan-browser/blob/main/Services/ThemeService.cs) (Theme Settings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_browser["Browser Core"]
  node_main["Window &amp; Tabs<br/>[MainWindow.xaml.cs]"]
  node_webview["WebView2 Pages<br/>[MainWindow.xaml.cs]"]
  node_session["Session Restore<br/>[SessionService.cs]"]
  node_incognito["Incognito Mode<br/>[MainWindow.xaml.cs]"]
  node_navigation["Address &amp; Search<br/>[MainWindow.xaml.cs]"]
end

subgraph group_privacy["Privacy &amp; Storage"]
  node_adblock["Ad &amp; Tracker Blocking"]
  node_passwords[("Password Vault<br/>[PasswordService.cs]")]
end

subgraph group_assistant["Local Assistant"]
  node_ollama["Ollama Server"]
  node_agan["Ağan Assistant<br/>[Agan.html]"]
  node_ollamaservice["Ollama Client<br/>[OllamaService.cs]"]
  node_personality[("Assistant Personality")]
end

subgraph group_features["Browser Features"]
  node_bookmarks[("Bookmarks<br/>[BookmarkService.cs]")]
  node_history[("Browsing History<br/>[HistoryService.cs]")]
  node_downloads["Download Tracking<br/>[DownloadService.cs]"]
  node_readlater[("Read Later PDFs")]
  node_extensions["Browser Extensions"]
  node_extensioncatalog["Extension Catalog"]
end

subgraph group_interface["Interface"]
  node_themes[("Theme Settings<br/>[ThemeService.cs]")]
  node_themefiles["Theme Resources"]
  node_dialogs["Feature Dialogs<br/>[DialogWindows.cs]"]
  node_dialoghelper["Dialog Helper<br/>[DialogHelper.cs]"]
  node_newtab["New Tab Page<br/>[NewTab.html]"]
  node_onboarding["Onboarding<br/>[Onboarding.html]"]
end

node_user(("Browser User"))

node_user -->|"uses"| node_main
node_main -->|"hosts pages"| node_webview
node_main -->|"saves session"| node_session
node_main -.->|"loads session"| node_session
node_main -->|"creates tabs"| node_incognito
node_main -.->|"handles navigation"| node_navigation
node_main -.->|"filters requests"| node_adblock
node_main -.->|"manages passwords"| node_passwords
node_main -.->|"manages bookmarks"| node_bookmarks
node_main -.->|"records history"| node_history
node_main -->|"tracks downloads"| node_main
node_main -->|"attaches handler"| node_downloads
node_main -.->|"archives pages"| node_readlater
node_main -.->|"installs extensions"| node_extensions
node_extensions -->|"fetches catalog"| node_extensioncatalog
node_main -->|"opens assistant"| node_agan
node_main -->|"streams chat"| node_ollamaservice
node_ollamaservice -->|"sends requests"| node_ollama
node_main -->|"gets prompts"| node_personality
node_main -->|"applies theme"| node_themes
node_themes -->|"loads resources"| node_themefiles
node_main -.->|"opens dialogs"| node_dialogs
node_main -->|"shows messages"| node_dialoghelper
node_webview -.->|"loads page"| node_newtab
node_user -.->|"starts onboarding"| node_onboarding

click node_main "https://github.com/kosmo471/agan-browser/blob/main/MainWindow.xaml.cs"
click node_webview "https://github.com/kosmo471/agan-browser/blob/main/MainWindow.xaml.cs"
click node_session "https://github.com/kosmo471/agan-browser/blob/main/Services/SessionService.cs"
click node_incognito "https://github.com/kosmo471/agan-browser/blob/main/MainWindow.xaml.cs"
click node_navigation "https://github.com/kosmo471/agan-browser/blob/main/MainWindow.xaml.cs"
click node_adblock "https://github.com/kosmo471/agan-browser/blob/main/Services/AdBlockerService.cs"
click node_passwords "https://github.com/kosmo471/agan-browser/blob/main/Services/PasswordService.cs"
click node_bookmarks "https://github.com/kosmo471/agan-browser/blob/main/Services/BookmarkService.cs"
click node_history "https://github.com/kosmo471/agan-browser/blob/main/Services/HistoryService.cs"
click node_downloads "https://github.com/kosmo471/agan-browser/blob/main/Services/DownloadService.cs"
click node_readlater "https://github.com/kosmo471/agan-browser/blob/main/Services/ReadLaterService.cs"
click node_extensions "https://github.com/kosmo471/agan-browser/blob/main/Services/ExtensionService.cs"
click node_extensioncatalog "https://github.com/kosmo471/agan-browser/blob/main/Services/ExtensionService.cs"
click node_agan "https://github.com/kosmo471/agan-browser/blob/main/Assets/Agan.html"
click node_ollamaservice "https://github.com/kosmo471/agan-browser/blob/main/Services/OllamaService.cs"
click node_personality "https://github.com/kosmo471/agan-browser/blob/main/Services/PersonalityService.cs"
click node_themes "https://github.com/kosmo471/agan-browser/blob/main/Services/ThemeService.cs"
click node_themefiles "https://github.com/kosmo471/agan-browser/tree/main/Themes"
click node_dialogs "https://github.com/kosmo471/agan-browser/blob/main/Services/DialogWindows.cs"
click node_dialoghelper "https://github.com/kosmo471/agan-browser/blob/main/Services/DialogHelper.cs"
click node_newtab "https://github.com/kosmo471/agan-browser/blob/main/Assets/NewTab.html"
click node_onboarding "https://github.com/kosmo471/agan-browser/blob/main/Assets/Onboarding.html"

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_main,node_webview,node_session,node_incognito,node_navigation,node_user toneBlue
class node_adblock,node_passwords toneAmber
class node_ollama,node_agan,node_ollamaservice,node_personality toneMint
class node_bookmarks,node_history,node_downloads,node_readlater,node_extensions,node_extensioncatalog toneRose
class node_themes,node_themefiles,node_dialogs,node_dialoghelper,node_newtab,node_onboarding toneIndigo
```

## Components

### Browser Core

- [Window & Tabs](https://github.com/kosmo471/agan-browser/blob/main/MainWindow.xaml.cs): `MainWindow.xaml.cs`
- [WebView2 Pages](https://github.com/kosmo471/agan-browser/blob/main/MainWindow.xaml.cs): `MainWindow.xaml.cs`
- [Session Restore](https://github.com/kosmo471/agan-browser/blob/main/Services/SessionService.cs): `Services/SessionService.cs`
- [Incognito Mode](https://github.com/kosmo471/agan-browser/blob/main/MainWindow.xaml.cs): `MainWindow.xaml.cs`
- [Address & Search](https://github.com/kosmo471/agan-browser/blob/main/MainWindow.xaml.cs): `MainWindow.xaml.cs`

### Privacy & Storage

- [Ad & Tracker Blocking](https://github.com/kosmo471/agan-browser/blob/main/Services/AdBlockerService.cs): `Services/AdBlockerService.cs`
- [Password Vault](https://github.com/kosmo471/agan-browser/blob/main/Services/PasswordService.cs): `Services/PasswordService.cs`

### Local Assistant

- **Ollama Server**
- [Ağan Assistant](https://github.com/kosmo471/agan-browser/blob/main/Assets/Agan.html): `Assets/Agan.html`
- [Ollama Client](https://github.com/kosmo471/agan-browser/blob/main/Services/OllamaService.cs): `Services/OllamaService.cs`
- [Assistant Personality](https://github.com/kosmo471/agan-browser/blob/main/Services/PersonalityService.cs): `Services/PersonalityService.cs`

### Browser Features

- [Bookmarks](https://github.com/kosmo471/agan-browser/blob/main/Services/BookmarkService.cs): `Services/BookmarkService.cs`
- [Browsing History](https://github.com/kosmo471/agan-browser/blob/main/Services/HistoryService.cs): `Services/HistoryService.cs`
- [Download Tracking](https://github.com/kosmo471/agan-browser/blob/main/Services/DownloadService.cs): `Services/DownloadService.cs`
- [Read Later PDFs](https://github.com/kosmo471/agan-browser/blob/main/Services/ReadLaterService.cs): `Services/ReadLaterService.cs`
- [Browser Extensions](https://github.com/kosmo471/agan-browser/blob/main/Services/ExtensionService.cs): `Services/ExtensionService.cs`
- [Extension Catalog](https://github.com/kosmo471/agan-browser/blob/main/Services/ExtensionService.cs): `Services/ExtensionService.cs`

### Interface

- [Theme Settings](https://github.com/kosmo471/agan-browser/blob/main/Services/ThemeService.cs): `Services/ThemeService.cs`
- [Theme Resources](https://github.com/kosmo471/agan-browser/tree/main/Themes): `Themes`
- [Feature Dialogs](https://github.com/kosmo471/agan-browser/blob/main/Services/DialogWindows.cs): `Services/DialogWindows.cs`
- [Dialog Helper](https://github.com/kosmo471/agan-browser/blob/main/Services/DialogHelper.cs): `Services/DialogHelper.cs`
- [New Tab Page](https://github.com/kosmo471/agan-browser/blob/main/Assets/NewTab.html): `Assets/NewTab.html`
- [Onboarding](https://github.com/kosmo471/agan-browser/blob/main/Assets/Onboarding.html): `Assets/Onboarding.html`

### Other components

- **Browser User**

## Connections

- Browser User → Window & Tabs: uses (evidence: `README.md`)
- Window & Tabs → WebView2 Pages: hosts pages (evidence: `MainWindow.xaml.cs`)
- Window & Tabs → Session Restore: saves session (evidence: `MainWindow.xaml.cs`)
- Window & Tabs → Session Restore: loads session (evidence: `README.md`)
- Window & Tabs → Incognito Mode: creates tabs (evidence: `MainWindow.xaml.cs`)
- Window & Tabs → Address & Search: handles navigation (evidence: `README.md`)
- Window & Tabs → Ad & Tracker Blocking: filters requests (evidence: `README.md`)
- Window & Tabs → Password Vault: manages passwords (evidence: `README.md`)
- Window & Tabs → Bookmarks: manages bookmarks (evidence: `MainWindow.xaml.cs`)
- Window & Tabs → Browsing History: records history (evidence: `MainWindow.xaml.cs`)
- Window & Tabs → Window & Tabs: tracks downloads (evidence: `MainWindow.xaml.cs`)
- Window & Tabs → Download Tracking: attaches handler (evidence: `MainWindow.xaml.cs`)
- Window & Tabs → Read Later PDFs: archives pages (evidence: `README.md`)
- Window & Tabs → Browser Extensions: installs extensions (evidence: `README.md`)
- Browser Extensions → Extension Catalog: fetches catalog (evidence: `Services/ExtensionService.cs`)
- Window & Tabs → Ağan Assistant: opens assistant (evidence: `MainWindow.xaml.cs`)
- Window & Tabs → Ollama Client: streams chat (evidence: `MainWindow.xaml.cs`)
- Ollama Client → Ollama Server: sends requests (evidence: `Services/OllamaService.cs`)
- Window & Tabs → Assistant Personality: gets prompts (evidence: `MainWindow.xaml.cs`)
- Window & Tabs → Theme Settings: applies theme (evidence: `MainWindow.xaml.cs`)
- Theme Settings → Theme Resources: loads resources (evidence: `Services/ThemeService.cs`)
- Window & Tabs → Feature Dialogs: opens dialogs (evidence: `README.md`)
- Window & Tabs → Dialog Helper: shows messages (evidence: `MainWindow.xaml.cs`)
- WebView2 Pages → New Tab Page: loads page (evidence: `README.md`)
- Browser User → Onboarding: starts onboarding (evidence: `README.md`)
