# cloudera/hue architecture

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

- Interactive diagram: https://gitdiagram.com/cloudera/hue
- Repository: https://github.com/cloudera/hue

## Overview

Hue is a web-based SQL assistant for databases and data warehouses. The principal workflow is a user editing SQL, submitting it through a database connector, and using the result to answer questions; the README also documents file operations, table exploration/import, job monitoring, and APIs. The graph preserves those product branches and the query-history/design layer. Relationships are supported by README capability statements or the SOURCE INDEX; most unsampled subsystems are represented at their exact enclosing directories, so their internal call paths are not inferred.

Main entry points: [`apps/beeswax/src/beeswax`](https://github.com/cloudera/hue/tree/master/apps/beeswax/src/beeswax) (SQL Editor), [`apps/jobbrowser/src/jobbrowser`](https://github.com/cloudera/hue/tree/master/apps/jobbrowser/src/jobbrowser) (Job Browser), [`apps/beeswax/src/beeswax/server/dbms.py`](https://github.com/cloudera/hue/blob/master/apps/beeswax/src/beeswax/server/dbms.py) (Hive Connector), [`apps/impala/src/impala`](https://github.com/cloudera/hue/tree/master/apps/impala/src/impala) (Impala Connector)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_query["SQL Querying"]
  node_editor["SQL Editor"]
  node_querydesign["Query Design<br/>[design.py]"]
  node_queryhistory[("Query History<br/>[query_history.py]")]
  node_beeswax["Hive Connector<br/>[dbms.py]"]
  node_impala["Impala Connector"]
  node_rdbms["RDBMS Connectors"]
  node_hbase["HBase Connector"]
  node_spark["Spark Connector"]
end

subgraph group_data["Data Management"]
  node_tables["Table Browser"]
  node_tableimport["Table Importer<br/>[create_table.py]"]
  node_filebrowser["File Browser"]
  node_storage["Cloud Storage"]
  node_search["Search<br/>[controller.py]"]
  node_indexer["Index Management<br/>[controller.py]"]
end

subgraph group_operations["Job Operations"]
  node_jobbrowser["Job Browser"]
  node_yarn["YARN Monitoring"]
  node_livy["Livy Jobs<br/>[livy_api.py]"]
  node_oozie["Workflow Scheduling"]
end

subgraph group_platform["Platform Services"]
  node_api["REST and Python APIs"]
  node_useradmin["User Administration<br/>[models.py]"]
  node_metadata["Metadata Service Client<br/>[manager_client.py]"]
end

node_user(("Hue user"))
node_database[("Configured Databases")]
node_hadoop["Hadoop Services"]

node_user -->|"edits SQL"| node_editor
node_editor -->|"submits queries"| node_beeswax
node_editor -->|"submits queries"| node_impala
node_editor -->|"submits queries"| node_rdbms
node_editor -->|"submits queries"| node_hbase
node_editor -->|"submits queries"| node_spark
node_beeswax -->|"executes queries"| node_database
node_impala -->|"executes queries"| node_database
node_rdbms -->|"executes queries"| node_database
node_hbase -->|"executes queries"| node_database
node_spark -->|"executes queries"| node_database
node_editor -.->|"designs queries"| node_querydesign
node_beeswax -->|"records history"| node_queryhistory
node_user -->|"browses files"| node_filebrowser
node_user -->|"browses storage"| node_storage
node_user -->|"explores tables"| node_tables
node_user -->|"imports data"| node_tableimport
node_tableimport -->|"creates tables"| node_beeswax
node_user -->|"monitors jobs"| node_jobbrowser
node_jobbrowser -->|"tracks Hive queries"| node_beeswax
node_jobbrowser -->|"tracks Impala queries"| node_impala
node_jobbrowser -->|"monitors applications"| node_yarn
node_jobbrowser -->|"monitors Spark jobs"| node_livy
node_user -.->|"schedules workflows"| node_oozie
node_user -.->|"searches data"| node_search
node_search -->|"manages index"| node_indexer
node_user -->|"uses APIs"| node_api
node_user -.->|"manages access"| node_useradmin
node_impala -->|"gets configuration"| node_metadata
node_filebrowser -->|"operates files"| node_hadoop
node_storage -->|"operates files"| node_hadoop

click node_editor "https://github.com/cloudera/hue/tree/master/apps/beeswax/src/beeswax"
click node_querydesign "https://github.com/cloudera/hue/blob/master/apps/beeswax/src/beeswax/design.py"
click node_queryhistory "https://github.com/cloudera/hue/blob/master/apps/beeswax/src/beeswax/query_history.py"
click node_beeswax "https://github.com/cloudera/hue/blob/master/apps/beeswax/src/beeswax/server/dbms.py"
click node_impala "https://github.com/cloudera/hue/tree/master/apps/impala/src/impala"
click node_rdbms "https://github.com/cloudera/hue/tree/master/apps/rdbms/src/rdbms"
click node_hbase "https://github.com/cloudera/hue/tree/master/apps/hbase/src/hbase"
click node_spark "https://github.com/cloudera/hue/tree/master/apps/spark/src/spark"
click node_tables "https://github.com/cloudera/hue/tree/master/apps/metastore/src/metastore"
click node_tableimport "https://github.com/cloudera/hue/blob/master/apps/beeswax/src/beeswax/create_table.py"
click node_filebrowser "https://github.com/cloudera/hue/tree/master/apps/filebrowser/src/filebrowser"
click node_storage "https://github.com/cloudera/hue/tree/master/desktop/core/src/desktop/js/apps/storageBrowser"
click node_jobbrowser "https://github.com/cloudera/hue/tree/master/apps/jobbrowser/src/jobbrowser"
click node_yarn "https://github.com/cloudera/hue/blob/master/desktop/libs/hadoop/src/hadoop/yarn/resource_manager_api.py"
click node_livy "https://github.com/cloudera/hue/blob/master/apps/jobbrowser/src/jobbrowser/apis/livy_api.py"
click node_oozie "https://github.com/cloudera/hue/tree/master/apps/oozie/src/oozie"
click node_search "https://github.com/cloudera/hue/blob/master/apps/search/src/search/controller.py"
click node_indexer "https://github.com/cloudera/hue/blob/master/desktop/libs/indexer/src/indexer/controller.py"
click node_api "https://github.com/cloudera/hue/tree/master/desktop"
click node_useradmin "https://github.com/cloudera/hue/blob/master/apps/useradmin/src/useradmin/models.py"
click node_metadata "https://github.com/cloudera/hue/blob/master/desktop/libs/metadata/src/metadata/manager_client.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_editor,node_querydesign,node_queryhistory,node_beeswax,node_impala,node_rdbms,node_hbase,node_spark,node_user toneBlue
class node_tables,node_tableimport,node_filebrowser,node_storage,node_search,node_indexer,node_database toneAmber
class node_jobbrowser,node_yarn,node_livy,node_oozie toneMint
class node_api,node_useradmin,node_metadata toneRose
class node_hadoop toneIndigo
```

## Components

### SQL Querying

- [SQL Editor](https://github.com/cloudera/hue/tree/master/apps/beeswax/src/beeswax): `apps/beeswax/src/beeswax`
- [Query Design](https://github.com/cloudera/hue/blob/master/apps/beeswax/src/beeswax/design.py): `apps/beeswax/src/beeswax/design.py`
- [Query History](https://github.com/cloudera/hue/blob/master/apps/beeswax/src/beeswax/query_history.py): `apps/beeswax/src/beeswax/query_history.py`
- [Hive Connector](https://github.com/cloudera/hue/blob/master/apps/beeswax/src/beeswax/server/dbms.py): `apps/beeswax/src/beeswax/server/dbms.py`
- [Impala Connector](https://github.com/cloudera/hue/tree/master/apps/impala/src/impala): `apps/impala/src/impala`
- [RDBMS Connectors](https://github.com/cloudera/hue/tree/master/apps/rdbms/src/rdbms): `apps/rdbms/src/rdbms`
- [HBase Connector](https://github.com/cloudera/hue/tree/master/apps/hbase/src/hbase): `apps/hbase/src/hbase`
- [Spark Connector](https://github.com/cloudera/hue/tree/master/apps/spark/src/spark): `apps/spark/src/spark`

### Data Management

- [Table Browser](https://github.com/cloudera/hue/tree/master/apps/metastore/src/metastore): `apps/metastore/src/metastore`
- [Table Importer](https://github.com/cloudera/hue/blob/master/apps/beeswax/src/beeswax/create_table.py): `apps/beeswax/src/beeswax/create_table.py`
- [File Browser](https://github.com/cloudera/hue/tree/master/apps/filebrowser/src/filebrowser): `apps/filebrowser/src/filebrowser`
- [Cloud Storage](https://github.com/cloudera/hue/tree/master/desktop/core/src/desktop/js/apps/storageBrowser): `desktop/core/src/desktop/js/apps/storageBrowser`
- [Search](https://github.com/cloudera/hue/blob/master/apps/search/src/search/controller.py): `apps/search/src/search/controller.py`
- [Index Management](https://github.com/cloudera/hue/blob/master/desktop/libs/indexer/src/indexer/controller.py): `desktop/libs/indexer/src/indexer/controller.py`

### Job Operations

- [Job Browser](https://github.com/cloudera/hue/tree/master/apps/jobbrowser/src/jobbrowser): `apps/jobbrowser/src/jobbrowser`
- [YARN Monitoring](https://github.com/cloudera/hue/blob/master/desktop/libs/hadoop/src/hadoop/yarn/resource_manager_api.py): `desktop/libs/hadoop/src/hadoop/yarn/resource_manager_api.py`
- [Livy Jobs](https://github.com/cloudera/hue/blob/master/apps/jobbrowser/src/jobbrowser/apis/livy_api.py): `apps/jobbrowser/src/jobbrowser/apis/livy_api.py`
- [Workflow Scheduling](https://github.com/cloudera/hue/tree/master/apps/oozie/src/oozie): `apps/oozie/src/oozie`

### Platform Services

- [REST and Python APIs](https://github.com/cloudera/hue/tree/master/desktop): `desktop`
- [User Administration](https://github.com/cloudera/hue/blob/master/apps/useradmin/src/useradmin/models.py): `apps/useradmin/src/useradmin/models.py`
- [Metadata Service Client](https://github.com/cloudera/hue/blob/master/desktop/libs/metadata/src/metadata/manager_client.py): `desktop/libs/metadata/src/metadata/manager_client.py`

### Other components

- **Hue user**
- **Configured Databases**
- **Hadoop Services**

## Connections

- Hue user → SQL Editor: edits SQL
- SQL Editor → Hive Connector: submits queries (evidence: `apps/beeswax/src/beeswax/query_history.py`)
- SQL Editor → Impala Connector: submits queries (evidence: `apps/beeswax/src/beeswax/server/dbms.py`)
- SQL Editor → RDBMS Connectors: submits queries
- SQL Editor → HBase Connector: submits queries
- SQL Editor → Spark Connector: submits queries (evidence: `apps/beeswax/src/beeswax/server/dbms.py`)
- Hive Connector → Configured Databases: executes queries
- Impala Connector → Configured Databases: executes queries
- RDBMS Connectors → Configured Databases: executes queries
- HBase Connector → Configured Databases: executes queries
- Spark Connector → Configured Databases: executes queries
- SQL Editor → Query Design: designs queries (evidence: `apps/beeswax/src/beeswax/query_history.py`)
- Hive Connector → Query History: records history (evidence: `apps/beeswax/src/beeswax/query_history.py`)
- Hue user → File Browser: browses files
- Hue user → Cloud Storage: browses storage
- Hue user → Table Browser: explores tables
- Hue user → Table Importer: imports data
- Table Importer → Hive Connector: creates tables
- Hue user → Job Browser: monitors jobs
- Job Browser → Hive Connector: tracks Hive queries
- Job Browser → Impala Connector: tracks Impala queries (evidence: `apps/jobbrowser/src/jobbrowser/apis/query_api.py`)
- Job Browser → YARN Monitoring: monitors applications
- Job Browser → Livy Jobs: monitors Spark jobs
- Hue user → Workflow Scheduling: schedules workflows
- Hue user → Search: searches data
- Search → Index Management: manages index (evidence: `desktop/libs/indexer/src/indexer/controller.py`)
- Hue user → REST and Python APIs: uses APIs
- Hue user → User Administration: manages access
- Impala Connector → Metadata Service Client: gets configuration (evidence: `apps/impala/src/impala/conf.py`)
- File Browser → Hadoop Services: operates files
- Cloud Storage → Hadoop Services: operates files
