# cobusgreyling/nemotron-3-ultra-showcase architecture

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

- Interactive diagram: https://gitdiagram.com/cobusgreyling/nemotron-3-ultra-showcase
- Repository: https://github.com/cobusgreyling/nemotron-3-ultra-showcase

## Overview

This is a Gradio feature showcase for NVIDIA Nemotron 3 Ultra. A user selects a reasoning mode and budget, submits a prompt, and sees streamed reasoning and an answer from the NVIDIA endpoint. A separate tool-calling workflow streams tool requests, executes the bundled arithmetic evaluator locally, then requests a final model response. The app also presents model architecture and generation guidance. The single source file implements the runtime; relationships not visible in the excerpts are supported only where the README documents them.

Main entry points: [`app.py`](https://github.com/cobusgreyling/nemotron-3-ultra-showcase/blob/main/app.py) (Gradio tabs)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Showcase interface"]
  node_gradio["Gradio tabs<br/>[app.py]"]
  node_playground["Reasoning playground<br/>[app.py]"]
  node_model_card["Model card<br/>[app.py]"]
end

subgraph group_model["Model interaction"]
  node_reasoning_handler["Reasoning stream<br/>[app.py]"]
  node_nvidia_api{{"Nemotron endpoint"}}
end

subgraph group_tools["Tool execution"]
  node_tool_loop["Tool-call loop<br/>[app.py]"]
  node_math_evaluator["Safe math evaluator<br/>[app.py]"]
end

node_user(("User"))

node_user -->|"uses"| node_gradio
node_gradio -->|"offers"| node_playground
node_gradio -->|"offers"| node_model_card
node_playground -->|"submits prompt"| node_reasoning_handler
node_reasoning_handler -->|"streams request"| node_nvidia_api
node_nvidia_api -->|"streams response"| node_reasoning_handler
node_gradio -->|"offers tool demo"| node_tool_loop
node_tool_loop -->|"requests tool calls"| node_nvidia_api
node_tool_loop -->|"executes tool"| node_math_evaluator
node_tool_loop -->|"requests final answer"| node_nvidia_api

click node_gradio "https://github.com/cobusgreyling/nemotron-3-ultra-showcase/blob/main/app.py"
click node_playground "https://github.com/cobusgreyling/nemotron-3-ultra-showcase/blob/main/app.py"
click node_model_card "https://github.com/cobusgreyling/nemotron-3-ultra-showcase/blob/main/app.py"
click node_reasoning_handler "https://github.com/cobusgreyling/nemotron-3-ultra-showcase/blob/main/app.py"
click node_tool_loop "https://github.com/cobusgreyling/nemotron-3-ultra-showcase/blob/main/app.py"
click node_math_evaluator "https://github.com/cobusgreyling/nemotron-3-ultra-showcase/blob/main/app.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_gradio,node_playground,node_model_card,node_user toneBlue
class node_reasoning_handler,node_nvidia_api toneAmber
class node_tool_loop,node_math_evaluator toneMint
```

## Components

### Showcase interface

- [Gradio tabs](https://github.com/cobusgreyling/nemotron-3-ultra-showcase/blob/main/app.py): `app.py`
- [Reasoning playground](https://github.com/cobusgreyling/nemotron-3-ultra-showcase/blob/main/app.py): `app.py`
- [Model card](https://github.com/cobusgreyling/nemotron-3-ultra-showcase/blob/main/app.py): `app.py`

### Model interaction

- [Reasoning stream](https://github.com/cobusgreyling/nemotron-3-ultra-showcase/blob/main/app.py): `app.py`
- **Nemotron endpoint**

### Tool execution

- [Tool-call loop](https://github.com/cobusgreyling/nemotron-3-ultra-showcase/blob/main/app.py): `app.py`
- [Safe math evaluator](https://github.com/cobusgreyling/nemotron-3-ultra-showcase/blob/main/app.py): `app.py`

### Other components

- **User**

## Connections

- User → Gradio tabs: uses (evidence: `README.md`)
- Gradio tabs → Reasoning playground: offers (evidence: `README.md`)
- Gradio tabs → Model card: offers (evidence: `README.md`)
- Reasoning playground → Reasoning stream: submits prompt (evidence: `README.md`)
- Reasoning stream → Nemotron endpoint: streams request (evidence: `README.md`)
- Nemotron endpoint → Reasoning stream: streams response (evidence: `README.md`)
- Gradio tabs → Tool-call loop: offers tool demo (evidence: `README.md`)
- Tool-call loop → Nemotron endpoint: requests tool calls (evidence: `README.md`)
- Tool-call loop → Safe math evaluator: executes tool (evidence: `app.py`)
- Tool-call loop → Nemotron endpoint: requests final answer (evidence: `app.py`)
