# ccb-hms/tooluniverse-ai-workshop architecture

> Architecture diagram of the GitHub repository ccb-hms/tooluniverse-ai-workshop, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ccb-hms/tooluniverse-ai-workshop
- Repository: https://github.com/ccb-hms/tooluniverse-ai-workshop

## Overview

This repository is a workshop resource, not the implementation of ToolUniverse. Its core user journey is to follow the setup guidance, connect ToolUniverse to an AI assistant, and try the clinical and genetics examples while inspecting tool-call traces. The README documents discovery and execution of tools against live scientific databases; implementation details are outside this repository, so the graph shows only those documented relationships.

Main entry points: [`slides/tooluniverse-workshop.pdf`](https://github.com/ccb-hms/tooluniverse-ai-workshop/blob/main/slides/tooluniverse-workshop.pdf) (Workshop deck), [`follow-along.md`](https://github.com/ccb-hms/tooluniverse-ai-workshop/blob/main/follow-along.md) (Example queries)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_materials["Workshop materials"]
  node_deck["Workshop deck"]
  node_examples["Example queries<br/>[follow-along.md]"]
end

subgraph group_platform["ToolUniverse workflow"]
  node_tooluniverse["ToolUniverse"]
end

node_learner(("Learner"))
node_assistant(("AI assistant"))
node_scientific_data[("Scientific databases")]

node_learner -->|"studies"| node_deck
node_learner -->|"follows"| node_examples
node_learner -->|"prompts"| node_assistant
node_assistant -->|"connects"| node_tooluniverse
node_assistant -->|"invokes tools"| node_tooluniverse
node_tooluniverse -->|"queries"| node_scientific_data

click node_deck "https://github.com/ccb-hms/tooluniverse-ai-workshop/blob/main/slides/tooluniverse-workshop.pdf"
click node_examples "https://github.com/ccb-hms/tooluniverse-ai-workshop/blob/main/follow-along.md"

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_deck,node_examples toneBlue
class node_tooluniverse,node_scientific_data toneAmber
class node_learner,node_assistant toneIndigo
```

## Components

### Workshop materials

- [Workshop deck](https://github.com/ccb-hms/tooluniverse-ai-workshop/blob/main/slides/tooluniverse-workshop.pdf): `slides/tooluniverse-workshop.pdf`
- [Example queries](https://github.com/ccb-hms/tooluniverse-ai-workshop/blob/main/follow-along.md): `follow-along.md`

### ToolUniverse workflow

- **ToolUniverse**

### Other components

- **Learner**
- **AI assistant**
- **Scientific databases**

## Connections

- Learner → Workshop deck: studies (evidence: `README.md`)
- Learner → Example queries: follows (evidence: `README.md`)
- Learner → AI assistant: prompts (evidence: `README.md`)
- AI assistant → ToolUniverse: connects (evidence: `README.md`)
- AI assistant → ToolUniverse: invokes tools (evidence: `README.md`)
- ToolUniverse → Scientific databases: queries (evidence: `README.md`)
