# opendatahub-io/odh-dashboard architecture

> Architecture diagram of the GitHub repository opendatahub-io/odh-dashboard, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/opendatahub-io/odh-dashboard
- Repository: https://github.com/opendatahub-io/odh-dashboard

## Overview

Open Data Hub Dashboard is a modular dashboard for navigating and interacting with Open Data Hub components. The principal user workflow is to enter through the dashboard UI, use a component or feature flow, and retrieve or update data through available APIs. The repository also contains shared pipeline APIs, feature-store search, LLM-serving configuration, and a Kubernetes operator. The README documents the frontend/backend split and feature packages; edges for specific internal calls are limited to relationships visible in the supplied source excerpts or SOURCE INDEX.

Main entry points: [`frontend`](https://github.com/opendatahub-io/odh-dashboard/tree/main/frontend) (Dashboard UI), [`packages/autox-core/ui/src/context/AutoXApiContext.tsx`](https://github.com/opendatahub-io/odh-dashboard/blob/main/packages/autox-core/ui/src/context/AutoXApiContext.tsx) (AutoX shared APIs), [`frontend/src/concepts/pipelines`](https://github.com/opendatahub-io/odh-dashboard/tree/main/frontend/src/concepts/pipelines) (Pipeline views), [`packages/autox-core/ui/src/hooks/pipelines/usePipelineRunQuery.ts`](https://github.com/opendatahub-io/odh-dashboard/blob/main/packages/autox-core/ui/src/hooks/pipelines/usePipelineRunQuery.ts) (Run status query)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_dashboard["Dashboard shell"]
  node_frontend["Dashboard UI"]
  node_pipelines["Pipeline views"]
  node_pipeline_query["Pipeline query"]
  node_browser_storage[("Browser preferences")]
end

subgraph group_feature_packages["Feature packages"]
  node_autox_core["AutoX shared APIs"]
  node_pipeline_run_query["Run status query"]
  node_pipeline_readiness["Server readiness"]
  node_automl["AutoML runs"]
  node_autorag["AutoRAG runs"]
  node_feature_store["Feature Store"]
  node_search_handlers["Store search"]
  node_search_state["Search state<br/>[useSearchState.ts]"]
  node_llmd_serving["LLM serving"]
  node_llmd_config_api["Serving config API"]
  node_llmd_delete["Config deletion"]
  node_gen_ai["Generative AI"]
  node_model_registry["Model Registry"]
  node_model_serving["Model Serving"]
end

subgraph group_backend["Backend services"]
  node_backend_api["Dashboard API"]
  node_core_bff["Core BFF"]
end

subgraph group_platform["Platform integration"]
  node_operator["Dashboard operator"]
  node_kubernetes[("Kubernetes cluster")]
end

node_user(("Dashboard user"))

node_user -->|"uses"| node_frontend
node_frontend -->|"requests API"| node_backend_api
node_frontend -->|"offers flows"| node_pipelines
node_pipelines -->|"queries runs"| node_pipeline_query
node_frontend -->|"stores preferences"| node_browser_storage
node_automl -->|"uses shared hooks"| node_autox_core
node_autorag -->|"uses shared hooks"| node_autox_core
node_autox_core -->|"provides query"| node_pipeline_run_query
node_pipeline_run_query -->|"reads API context"| node_autox_core
node_pipeline_readiness -->|"reads API context"| node_autox_core
node_feature_store -.->|"supports search"| node_search_handlers
node_search_handlers -->|"updates state"| node_search_state
node_llmd_serving -.->|"supports config management"| node_llmd_delete
node_llmd_delete -->|"deletes config"| node_llmd_config_api
node_frontend -->|"hosts feature packages"| node_gen_ai
node_frontend -->|"hosts feature packages"| node_model_registry
node_frontend -->|"hosts feature packages"| node_model_serving
node_core_bff -.->|"serves dashboard"| node_frontend
node_operator -.->|"reconciles resources"| node_kubernetes

click node_frontend "https://github.com/opendatahub-io/odh-dashboard/tree/main/frontend"
click node_pipelines "https://github.com/opendatahub-io/odh-dashboard/tree/main/frontend/src/concepts/pipelines"
click node_pipeline_query "https://github.com/opendatahub-io/odh-dashboard/blob/main/frontend/src/concepts/pipelines/apiHooks/usePipelineQuery.ts"
click node_browser_storage "https://github.com/opendatahub-io/odh-dashboard/blob/main/packages/ui-core/src/hooks/useBrowserStorage.tsx"
click node_autox_core "https://github.com/opendatahub-io/odh-dashboard/blob/main/packages/autox-core/ui/src/context/AutoXApiContext.tsx"
click node_pipeline_run_query "https://github.com/opendatahub-io/odh-dashboard/blob/main/packages/autox-core/ui/src/hooks/pipelines/usePipelineRunQuery.ts"
click node_pipeline_readiness "https://github.com/opendatahub-io/odh-dashboard/blob/main/packages/autox-core/ui/src/hooks/pipelines/usePipelineServerReadinessQuery.ts"
click node_automl "https://github.com/opendatahub-io/odh-dashboard/tree/main/packages/automl"
click node_autorag "https://github.com/opendatahub-io/odh-dashboard/tree/main/packages/autorag"
click node_feature_store "https://github.com/opendatahub-io/odh-dashboard/blob/main/packages/feature-store/src/FeatureStoreRoutes.tsx"
click node_search_handlers "https://github.com/opendatahub-io/odh-dashboard/blob/main/packages/feature-store/src/components/FeatureStoreGlobalSearch/hooks/useSearchHandlers.ts"
click node_search_state "https://github.com/opendatahub-io/odh-dashboard/blob/main/packages/feature-store/src/components/FeatureStoreGlobalSearch/hooks/useSearchState.ts"
click node_llmd_serving "https://github.com/opendatahub-io/odh-dashboard/tree/main/packages/llmd-serving"
click node_llmd_config_api "https://github.com/opendatahub-io/odh-dashboard/blob/main/packages/llmd-serving/src/api/LLMInferenceServiceConfigs.ts"
click node_llmd_delete "https://github.com/opendatahub-io/odh-dashboard/blob/main/packages/llmd-serving/src/settings/useDeleteLlmInferenceServiceConfig.ts"
click node_gen_ai "https://github.com/opendatahub-io/odh-dashboard/tree/main/packages/gen-ai"
click node_model_registry "https://github.com/opendatahub-io/odh-dashboard/tree/main/packages/model-registry"
click node_model_serving "https://github.com/opendatahub-io/odh-dashboard/tree/main/packages/model-serving"
click node_backend_api "https://github.com/opendatahub-io/odh-dashboard/tree/main/backend/src/routes"
click node_core_bff "https://github.com/opendatahub-io/odh-dashboard/tree/main/distributions/core-bff/bff/internal/api"
click node_operator "https://github.com/opendatahub-io/odh-dashboard/tree/main/dashboard-operator/internal/controller"

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_frontend,node_pipelines,node_pipeline_query,node_browser_storage,node_user toneBlue
class node_autox_core,node_pipeline_run_query,node_pipeline_readiness,node_automl,node_autorag,node_feature_store,node_search_handlers,node_search_state,node_llmd_serving,node_llmd_config_api,node_llmd_delete,node_gen_ai,node_model_registry,node_model_serving toneAmber
class node_backend_api,node_core_bff toneMint
class node_operator,node_kubernetes toneRose
```

## Components

### Dashboard shell

- [Dashboard UI](https://github.com/opendatahub-io/odh-dashboard/tree/main/frontend): `frontend`
- [Pipeline views](https://github.com/opendatahub-io/odh-dashboard/tree/main/frontend/src/concepts/pipelines): `frontend/src/concepts/pipelines`
- [Pipeline query](https://github.com/opendatahub-io/odh-dashboard/blob/main/frontend/src/concepts/pipelines/apiHooks/usePipelineQuery.ts): `frontend/src/concepts/pipelines/apiHooks/usePipelineQuery.ts`
- [Browser preferences](https://github.com/opendatahub-io/odh-dashboard/blob/main/packages/ui-core/src/hooks/useBrowserStorage.tsx): `packages/ui-core/src/hooks/useBrowserStorage.tsx`

### Feature packages

- [AutoX shared APIs](https://github.com/opendatahub-io/odh-dashboard/blob/main/packages/autox-core/ui/src/context/AutoXApiContext.tsx): `packages/autox-core/ui/src/context/AutoXApiContext.tsx`
- [Run status query](https://github.com/opendatahub-io/odh-dashboard/blob/main/packages/autox-core/ui/src/hooks/pipelines/usePipelineRunQuery.ts): `packages/autox-core/ui/src/hooks/pipelines/usePipelineRunQuery.ts`
- [Server readiness](https://github.com/opendatahub-io/odh-dashboard/blob/main/packages/autox-core/ui/src/hooks/pipelines/usePipelineServerReadinessQuery.ts): `packages/autox-core/ui/src/hooks/pipelines/usePipelineServerReadinessQuery.ts`
- [AutoML runs](https://github.com/opendatahub-io/odh-dashboard/tree/main/packages/automl): `packages/automl`
- [AutoRAG runs](https://github.com/opendatahub-io/odh-dashboard/tree/main/packages/autorag): `packages/autorag`
- [Feature Store](https://github.com/opendatahub-io/odh-dashboard/blob/main/packages/feature-store/src/FeatureStoreRoutes.tsx): `packages/feature-store/src/FeatureStoreRoutes.tsx`
- [Store search](https://github.com/opendatahub-io/odh-dashboard/blob/main/packages/feature-store/src/components/FeatureStoreGlobalSearch/hooks/useSearchHandlers.ts): `packages/feature-store/src/components/FeatureStoreGlobalSearch/hooks/useSearchHandlers.ts`
- [Search state](https://github.com/opendatahub-io/odh-dashboard/blob/main/packages/feature-store/src/components/FeatureStoreGlobalSearch/hooks/useSearchState.ts): `packages/feature-store/src/components/FeatureStoreGlobalSearch/hooks/useSearchState.ts`
- [LLM serving](https://github.com/opendatahub-io/odh-dashboard/tree/main/packages/llmd-serving): `packages/llmd-serving`
- [Serving config API](https://github.com/opendatahub-io/odh-dashboard/blob/main/packages/llmd-serving/src/api/LLMInferenceServiceConfigs.ts): `packages/llmd-serving/src/api/LLMInferenceServiceConfigs.ts`
- [Config deletion](https://github.com/opendatahub-io/odh-dashboard/blob/main/packages/llmd-serving/src/settings/useDeleteLlmInferenceServiceConfig.ts): `packages/llmd-serving/src/settings/useDeleteLlmInferenceServiceConfig.ts`
- [Generative AI](https://github.com/opendatahub-io/odh-dashboard/tree/main/packages/gen-ai): `packages/gen-ai`
- [Model Registry](https://github.com/opendatahub-io/odh-dashboard/tree/main/packages/model-registry): `packages/model-registry`
- [Model Serving](https://github.com/opendatahub-io/odh-dashboard/tree/main/packages/model-serving): `packages/model-serving`

### Backend services

- [Dashboard API](https://github.com/opendatahub-io/odh-dashboard/tree/main/backend/src/routes): `backend/src/routes`
- [Core BFF](https://github.com/opendatahub-io/odh-dashboard/tree/main/distributions/core-bff/bff/internal/api): `distributions/core-bff/bff/internal/api`

### Platform integration

- [Dashboard operator](https://github.com/opendatahub-io/odh-dashboard/tree/main/dashboard-operator/internal/controller): `dashboard-operator/internal/controller`
- **Kubernetes cluster**

### Other components

- **Dashboard user**

## Connections

- Dashboard user → Dashboard UI: uses (evidence: `README.md`)
- Dashboard UI → Dashboard API: requests API (evidence: `README.md`)
- Dashboard UI → Pipeline views: offers flows (evidence: `README.md`)
- Pipeline views → Pipeline query: queries runs (evidence: `frontend/src/concepts/pipelines/apiHooks/usePipelineQuery.ts`)
- Dashboard UI → Browser preferences: stores preferences (evidence: `packages/ui-core/src/hooks/useBrowserStorage.tsx`)
- AutoML runs → AutoX shared APIs: uses shared hooks (evidence: `packages/automl/frontend/src/app/hooks/useCreatePipelineRunMutation.ts`)
- AutoRAG runs → AutoX shared APIs: uses shared hooks (evidence: `packages/autorag/frontend/src/app/hooks/usePipelineRunQuery.ts`)
- AutoX shared APIs → Run status query: provides query (evidence: `packages/autox-core/ui/src/context/AutoXApiContext.tsx`)
- Run status query → AutoX shared APIs: reads API context (evidence: `packages/autox-core/ui/src/hooks/pipelines/usePipelineRunQuery.ts`)
- Server readiness → AutoX shared APIs: reads API context (evidence: `packages/autox-core/ui/src/hooks/pipelines/usePipelineServerReadinessQuery.ts`)
- Feature Store → Store search: supports search
- Store search → Search state: updates state (evidence: `packages/feature-store/src/components/FeatureStoreGlobalSearch/hooks/useSearchHandlers.ts`)
- LLM serving → Config deletion: supports config management (evidence: `packages/llmd-serving/src/settings/useDeleteLlmInferenceServiceConfig.ts`)
- Config deletion → Serving config API: deletes config (evidence: `packages/llmd-serving/src/settings/useDeleteLlmInferenceServiceConfig.ts`)
- Dashboard UI → Generative AI: hosts feature packages (evidence: `README.md`)
- Dashboard UI → Model Registry: hosts feature packages (evidence: `README.md`)
- Dashboard UI → Model Serving: hosts feature packages (evidence: `README.md`)
- Core BFF → Dashboard UI: serves dashboard
- Dashboard operator → Kubernetes cluster: reconciles resources
