# oracle-devrel/oracle-ai-developer-hub architecture

> Architecture diagram of the GitHub repository oracle-devrel/oracle-ai-developer-hub, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/oracle-devrel/oracle-ai-developer-hub
- Repository: https://github.com/oracle-devrel/oracle-ai-developer-hub

## Overview

Oracle AI Developer Hub is a collection of independent applications and reference implementations, not one integrated runtime. A developer selects an example and follows its own user-to-result workflow; the README describes the examples’ capabilities, but does not establish runtime links between them. The graph preserves the README’s major application branches and the sampled central modules that exist in the supplied tree. Internal calls between these separate products are omitted because the excerpts do not show them.

Main entry points: [`apps/agentic_rag`](https://github.com/oracle-devrel/oracle-ai-developer-hub/tree/main/apps/agentic_rag) (Multi-agent RAG), [`apps/oracle-rag`](https://github.com/oracle-devrel/oracle-ai-developer-hub/tree/main/apps/oracle-rag) (Oracle RAG), [`apps/team-brain`](https://github.com/oracle-devrel/oracle-ai-developer-hub/tree/main/apps/team-brain) (Team knowledge), [`apps/supplychain-demand-planning-agent`](https://github.com/oracle-devrel/oracle-ai-developer-hub/tree/main/apps/supplychain-demand-planning-agent) (Demand planning)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_rag["RAG And Search"]
  node_agentic_rag["Multi-agent RAG"]
  node_file_handler["File processing<br/>[file_handler.py]"]
  node_oracle_rag["Oracle RAG"]
end

subgraph group_agents["Agents And Memory"]
  node_team_brain["Team knowledge"]
  node_team_config["Access configuration<br/>[config.py]"]
  node_supplychain_agent["Demand planning"]
  node_finance_agent["Finance agent"]
  node_finance_queries["Database queries<br/>[query_helper.py]"]
  node_finance_text["Text retrieval<br/>[text_search.py]"]
end

subgraph group_data["Data Applications"]
  node_migration["RAG migration"]
  node_idp["Document processor"]
  node_data_chat["Generative data chat"]
  node_fittracker["Gamified fitness"]
  node_shoe_store["Natural-language store"]
  node_jet_ui["OCI GenAI application"]
  node_oraviz["Database visualization MCP"]
  node_oraviz_charts["Chart rendering<br/>[charts.py]"]
  node_oraviz_policy["Tool policy<br/>[tool_policy.py]"]
end

subgraph group_samples["Vector Samples"]
  node_vector_samples["Vector development samples"]
end

node_developer(("AI developer"))

node_developer -->|"explores example"| node_fittracker
node_developer -->|"explores example"| node_agentic_rag
node_developer -->|"explores example"| node_finance_agent
node_developer -->|"explores example"| node_data_chat
node_developer -->|"explores example"| node_jet_ui
node_developer -->|"explores example"| node_shoe_store
node_developer -->|"explores example"| node_team_brain
node_developer -->|"explores example"| node_migration
node_developer -->|"explores example"| node_supplychain_agent
node_developer -->|"explores example"| node_idp
node_developer -->|"explores examples"| node_vector_samples
node_developer -->|"explores example"| node_oraviz
node_developer -->|"explores example"| node_oracle_rag

click node_agentic_rag "https://github.com/oracle-devrel/oracle-ai-developer-hub/tree/main/apps/agentic_rag"
click node_file_handler "https://github.com/oracle-devrel/oracle-ai-developer-hub/blob/main/apps/agentic_rag/src/file_handler.py"
click node_oracle_rag "https://github.com/oracle-devrel/oracle-ai-developer-hub/tree/main/apps/oracle-rag"
click node_team_brain "https://github.com/oracle-devrel/oracle-ai-developer-hub/tree/main/apps/team-brain"
click node_team_config "https://github.com/oracle-devrel/oracle-ai-developer-hub/blob/main/apps/team-brain/team_brain/config.py"
click node_supplychain_agent "https://github.com/oracle-devrel/oracle-ai-developer-hub/tree/main/apps/supplychain-demand-planning-agent"
click node_finance_agent "https://github.com/oracle-devrel/oracle-ai-developer-hub/tree/main/apps/finance-ai-agent-demo"
click node_finance_queries "https://github.com/oracle-devrel/oracle-ai-developer-hub/blob/main/apps/finance-ai-agent-demo/backend/database/query_helper.py"
click node_finance_text "https://github.com/oracle-devrel/oracle-ai-developer-hub/blob/main/apps/finance-ai-agent-demo/backend/retrieval/text_search.py"
click node_migration "https://github.com/oracle-devrel/oracle-ai-developer-hub/tree/main/apps/oracle-data-migration-harness"
click node_idp "https://github.com/oracle-devrel/oracle-ai-developer-hub/tree/main/apps/idp-oracle-ai-database"
click node_data_chat "https://github.com/oracle-devrel/oracle-ai-developer-hub/tree/main/apps/generative-ui-data-chat"
click node_fittracker "https://github.com/oracle-devrel/oracle-ai-developer-hub/tree/main/apps/FitTracker"
click node_shoe_store "https://github.com/oracle-devrel/oracle-ai-developer-hub/tree/main/apps/tanstack-shoe-store"
click node_jet_ui "https://github.com/oracle-devrel/oracle-ai-developer-hub/tree/main/apps/oci-generative-ai-jet-ui"
click node_oraviz "https://github.com/oracle-devrel/oracle-ai-developer-hub/tree/main/apps/oraviz-mcp"
click node_oraviz_charts "https://github.com/oracle-devrel/oracle-ai-developer-hub/blob/main/apps/oraviz-mcp/src/oraviz_mcp/charts.py"
click node_oraviz_policy "https://github.com/oracle-devrel/oracle-ai-developer-hub/blob/main/apps/oraviz-mcp/src/oraviz_mcp/tool_policy.py"
click node_vector_samples "https://github.com/oracle-devrel/oracle-ai-developer-hub/tree/main/apps/vecdb"

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_agentic_rag,node_file_handler,node_oracle_rag toneBlue
class node_team_brain,node_team_config,node_supplychain_agent,node_finance_agent,node_finance_queries,node_finance_text toneAmber
class node_migration,node_idp,node_data_chat,node_fittracker,node_shoe_store,node_jet_ui,node_oraviz,node_oraviz_charts,node_oraviz_policy toneMint
class node_vector_samples toneRose
class node_developer toneIndigo
```

## Components

### RAG And Search

- [Multi-agent RAG](https://github.com/oracle-devrel/oracle-ai-developer-hub/tree/main/apps/agentic_rag): `apps/agentic_rag`
- [File processing](https://github.com/oracle-devrel/oracle-ai-developer-hub/blob/main/apps/agentic_rag/src/file_handler.py): `apps/agentic_rag/src/file_handler.py`
- [Oracle RAG](https://github.com/oracle-devrel/oracle-ai-developer-hub/tree/main/apps/oracle-rag): `apps/oracle-rag`

### Agents And Memory

- [Team knowledge](https://github.com/oracle-devrel/oracle-ai-developer-hub/tree/main/apps/team-brain): `apps/team-brain`
- [Access configuration](https://github.com/oracle-devrel/oracle-ai-developer-hub/blob/main/apps/team-brain/team_brain/config.py): `apps/team-brain/team_brain/config.py`
- [Demand planning](https://github.com/oracle-devrel/oracle-ai-developer-hub/tree/main/apps/supplychain-demand-planning-agent): `apps/supplychain-demand-planning-agent`
- [Finance agent](https://github.com/oracle-devrel/oracle-ai-developer-hub/tree/main/apps/finance-ai-agent-demo): `apps/finance-ai-agent-demo`
- [Database queries](https://github.com/oracle-devrel/oracle-ai-developer-hub/blob/main/apps/finance-ai-agent-demo/backend/database/query_helper.py): `apps/finance-ai-agent-demo/backend/database/query_helper.py`
- [Text retrieval](https://github.com/oracle-devrel/oracle-ai-developer-hub/blob/main/apps/finance-ai-agent-demo/backend/retrieval/text_search.py): `apps/finance-ai-agent-demo/backend/retrieval/text_search.py`

### Data Applications

- [RAG migration](https://github.com/oracle-devrel/oracle-ai-developer-hub/tree/main/apps/oracle-data-migration-harness): `apps/oracle-data-migration-harness`
- [Document processor](https://github.com/oracle-devrel/oracle-ai-developer-hub/tree/main/apps/idp-oracle-ai-database): `apps/idp-oracle-ai-database`
- [Generative data chat](https://github.com/oracle-devrel/oracle-ai-developer-hub/tree/main/apps/generative-ui-data-chat): `apps/generative-ui-data-chat`
- [Gamified fitness](https://github.com/oracle-devrel/oracle-ai-developer-hub/tree/main/apps/FitTracker): `apps/FitTracker`
- [Natural-language store](https://github.com/oracle-devrel/oracle-ai-developer-hub/tree/main/apps/tanstack-shoe-store): `apps/tanstack-shoe-store`
- [OCI GenAI application](https://github.com/oracle-devrel/oracle-ai-developer-hub/tree/main/apps/oci-generative-ai-jet-ui): `apps/oci-generative-ai-jet-ui`
- [Database visualization MCP](https://github.com/oracle-devrel/oracle-ai-developer-hub/tree/main/apps/oraviz-mcp): `apps/oraviz-mcp`
- [Chart rendering](https://github.com/oracle-devrel/oracle-ai-developer-hub/blob/main/apps/oraviz-mcp/src/oraviz_mcp/charts.py): `apps/oraviz-mcp/src/oraviz_mcp/charts.py`
- [Tool policy](https://github.com/oracle-devrel/oracle-ai-developer-hub/blob/main/apps/oraviz-mcp/src/oraviz_mcp/tool_policy.py): `apps/oraviz-mcp/src/oraviz_mcp/tool_policy.py`

### Vector Samples

- [Vector development samples](https://github.com/oracle-devrel/oracle-ai-developer-hub/tree/main/apps/vecdb): `apps/vecdb`

### Other components

- **AI developer**

## Connections

- AI developer → Gamified fitness: explores example
- AI developer → Multi-agent RAG: explores example
- AI developer → Finance agent: explores example
- AI developer → Generative data chat: explores example
- AI developer → OCI GenAI application: explores example
- AI developer → Natural-language store: explores example
- AI developer → Team knowledge: explores example
- AI developer → RAG migration: explores example
- AI developer → Demand planning: explores example
- AI developer → Document processor: explores example
- AI developer → Vector development samples: explores examples
- AI developer → Database visualization MCP: explores example
- AI developer → Oracle RAG: explores example
