# kannaseka/dental-ai-treament-planner architecture

> Architecture diagram of the GitHub repository kannaseka/dental-ai-treament-planner, 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/kannaseka/dental-ai-treament-planner
- Repository: https://github.com/kannaseka/dental-ai-treament-planner

## Overview

Dental AI Treatment Planner combines X-ray detection with clinical-guideline retrieval and treatment planning, exposed through REST, Gradio, CLI, and MCP interfaces. The main diagnosis path analyzes an image, uses detected conditions to support treatment recommendations, and can provide cost estimates. The graph includes README-documented capabilities, but several source excerpts omit endpoint and tool bodies; only visible or documented relationships are shown.

Main entry points: [`src/api/main.py`](https://github.com/kannaseka/dental-ai-treament-planner/blob/main/src/api/main.py) (REST API), [`src/vision/dental_analyzer.py`](https://github.com/kannaseka/dental-ai-treament-planner/blob/main/src/vision/dental_analyzer.py) (X-ray analysis), [`src/rag/dental_rag.py`](https://github.com/kannaseka/dental-ai-treament-planner/blob/main/src/rag/dental_rag.py) (Guidelines and plans), [`src/cli.py`](https://github.com/kannaseka/dental-ai-treament-planner/blob/main/src/cli.py) (CLI commands)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["User Interfaces"]
  node_cli["CLI commands<br/>[cli.py]"]
  node_rest["REST API<br/>[main.py]"]
  node_demo["Gradio demo<br/>[demo.py]"]
  node_mcp["MCP tools<br/>[server.py]"]
end

subgraph group_diagnosis["Dental Analysis"]
  node_vision["X-ray analysis<br/>[dental_analyzer.py]"]
end

subgraph group_planning["Clinical Planning"]
  node_rag["Guidelines and plans<br/>[dental_rag.py]"]
  node_cost["Cost estimates<br/>[main.py]"]
end

node_user(("Dental professional"))
node_assistant(("AI assistant"))

node_user -->|"runs commands"| node_cli
node_user -->|"sends requests"| node_rest
node_user -->|"uses demo"| node_demo
node_assistant -->|"invokes tools"| node_mcp
node_cli -->|"analyzes images"| node_vision
node_cli -->|"requests plans"| node_rag
node_rest -->|"analyzes images"| node_vision
node_rest -->|"retrieves guidelines"| node_rag
node_rest -->|"calculates estimates"| node_cost
node_demo -->|"analyzes images"| node_vision
node_demo -->|"requests plans"| node_rag
node_mcp -->|"analyzes images"| node_vision
node_mcp -->|"retrieves guidelines"| node_rag

click node_cli "https://github.com/kannaseka/dental-ai-treament-planner/blob/main/src/cli.py"
click node_rest "https://github.com/kannaseka/dental-ai-treament-planner/blob/main/src/api/main.py"
click node_demo "https://github.com/kannaseka/dental-ai-treament-planner/blob/main/src/api/demo.py"
click node_mcp "https://github.com/kannaseka/dental-ai-treament-planner/blob/main/src/mcp_server/server.py"
click node_vision "https://github.com/kannaseka/dental-ai-treament-planner/blob/main/src/vision/dental_analyzer.py"
click node_rag "https://github.com/kannaseka/dental-ai-treament-planner/blob/main/src/rag/dental_rag.py"
click node_cost "https://github.com/kannaseka/dental-ai-treament-planner/blob/main/src/api/main.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_cli,node_rest,node_demo,node_mcp toneBlue
class node_vision toneAmber
class node_rag,node_cost toneMint
class node_user,node_assistant toneIndigo
```

## Components

### User Interfaces

- [CLI commands](https://github.com/kannaseka/dental-ai-treament-planner/blob/main/src/cli.py): `src/cli.py`
- [REST API](https://github.com/kannaseka/dental-ai-treament-planner/blob/main/src/api/main.py): `src/api/main.py`
- [Gradio demo](https://github.com/kannaseka/dental-ai-treament-planner/blob/main/src/api/demo.py): `src/api/demo.py`
- [MCP tools](https://github.com/kannaseka/dental-ai-treament-planner/blob/main/src/mcp_server/server.py): `src/mcp_server/server.py`

### Dental Analysis

- [X-ray analysis](https://github.com/kannaseka/dental-ai-treament-planner/blob/main/src/vision/dental_analyzer.py): `src/vision/dental_analyzer.py`

### Clinical Planning

- [Guidelines and plans](https://github.com/kannaseka/dental-ai-treament-planner/blob/main/src/rag/dental_rag.py): `src/rag/dental_rag.py`
- [Cost estimates](https://github.com/kannaseka/dental-ai-treament-planner/blob/main/src/api/main.py): `src/api/main.py`

### Other components

- **Dental professional**
- **AI assistant**

## Connections

- Dental professional → CLI commands: runs commands (evidence: `README.md`)
- Dental professional → REST API: sends requests (evidence: `README.md`)
- Dental professional → Gradio demo: uses demo (evidence: `README.md`)
- AI assistant → MCP tools: invokes tools (evidence: `README.md`)
- CLI commands → X-ray analysis: analyzes images (evidence: `src/cli.py`)
- CLI commands → Guidelines and plans: requests plans (evidence: `src/cli.py`)
- REST API → X-ray analysis: analyzes images (evidence: `src/api/main.py`)
- REST API → Guidelines and plans: retrieves guidelines (evidence: `src/api/main.py`)
- REST API → Cost estimates: calculates estimates (evidence: `src/api/main.py`)
- Gradio demo → X-ray analysis: analyzes images (evidence: `src/api/demo.py`)
- Gradio demo → Guidelines and plans: requests plans (evidence: `src/api/demo.py`)
- MCP tools → X-ray analysis: analyzes images (evidence: `src/mcp_server/server.py`)
- MCP tools → Guidelines and plans: retrieves guidelines (evidence: `src/mcp_server/server.py`)
