# lislema/nvidia-guardrails architecture

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

- Interactive diagram: https://gitdiagram.com/lislema/nvidia-guardrails
- Repository: https://github.com/lislema/nvidia-guardrails

## Overview

This is a Streamlit IT incident-management chatbot protected by a FastAPI/NeMo Guardrails service. Users can test a message through classification alone or submit an incident form for classification and an AI support response. The documented checks include jailbreak detection, semantic IT classification, and a keyword fallback. The excerpts show the service loading Colang rails and the UI making HTTP requests; details of some API-stage implementations are omitted, so the graph relies on documented relationships for those stages.

Main entry points: [`config/main.py`](https://github.com/lislema/nvidia-guardrails/blob/main/config/main.py) (Incident check endpoint), [`streamlit/app.py`](https://github.com/lislema/nvidia-guardrails/blob/main/streamlit/app.py) (Streamlit app), [`rails/incident_rails.co`](https://github.com/lislema/nvidia-guardrails/blob/main/rails/incident_rails.co) (Colang rails), [`config/config.yaml`](https://github.com/lislema/nvidia-guardrails/blob/main/config/config.yaml) (Language policy config)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["User interface"]
  node_ui["Streamlit app<br/>[app.py]"]
  node_ui_labels["Translated labels"]
end

subgraph group_service["Guardrails service"]
  node_classify_api["Classify endpoint<br/>[main.py]"]
  node_check_api["Incident check endpoint<br/>[main.py]"]
end

subgraph group_policy["Policy and rails"]
  node_security["Jailbreak detection<br/>[main.py]"]
  node_semantic["Semantic classification<br/>[main.py]"]
  node_keyword["Keyword fallback<br/>[main.py]"]
  node_policy_config["Language policy config<br/>[config.yaml]"]
  node_rails["Colang rails<br/>[incident_rails.co]"]
  node_custom_actions["Incident actions<br/>[actions.py]"]
end

subgraph group_ai["AI response"]
  node_response["IT support response<br/>[main.py]"]
end

node_user(("Incident reporter"))
node_llm{{"LLM provider"}}

node_user -->|"submits message"| node_ui
node_ui -->|"loads labels"| node_ui_labels
node_ui -->|"POST /classify"| node_classify_api
node_ui -->|"POST /check"| node_check_api
node_check_api -->|"checks jailbreak"| node_security
node_classify_api -->|"checks jailbreak"| node_security
node_check_api -->|"classifies message"| node_semantic
node_classify_api -->|"classifies message"| node_semantic
node_classify_api -->|"falls back"| node_keyword
node_check_api -->|"checks keywords"| node_keyword
node_security -->|"uses patterns"| node_policy_config
node_keyword -->|"uses keywords"| node_policy_config
node_check_api -->|"generates response"| node_response
node_response -->|"requests completion"| node_llm
node_check_api -->|"loads flows"| node_rails
node_rails -.->|"may invoke"| node_custom_actions

click node_ui "https://github.com/lislema/nvidia-guardrails/blob/main/streamlit/app.py"
click node_ui_labels "https://github.com/lislema/nvidia-guardrails/tree/main/streamlit/labels"
click node_classify_api "https://github.com/lislema/nvidia-guardrails/blob/main/config/main.py"
click node_check_api "https://github.com/lislema/nvidia-guardrails/blob/main/config/main.py"
click node_security "https://github.com/lislema/nvidia-guardrails/blob/main/config/main.py"
click node_semantic "https://github.com/lislema/nvidia-guardrails/blob/main/config/main.py"
click node_keyword "https://github.com/lislema/nvidia-guardrails/blob/main/config/main.py"
click node_policy_config "https://github.com/lislema/nvidia-guardrails/blob/main/config/config.yaml"
click node_rails "https://github.com/lislema/nvidia-guardrails/blob/main/rails/incident_rails.co"
click node_custom_actions "https://github.com/lislema/nvidia-guardrails/blob/main/config/actions.py"
click node_response "https://github.com/lislema/nvidia-guardrails/blob/main/config/main.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_ui,node_ui_labels toneBlue
class node_classify_api,node_check_api toneAmber
class node_security,node_semantic,node_keyword,node_policy_config,node_rails,node_custom_actions toneMint
class node_response toneRose
class node_user,node_llm toneIndigo
```

## Components

### User interface

- [Streamlit app](https://github.com/lislema/nvidia-guardrails/blob/main/streamlit/app.py): `streamlit/app.py`
- [Translated labels](https://github.com/lislema/nvidia-guardrails/tree/main/streamlit/labels): `streamlit/labels`

### Guardrails service

- [Classify endpoint](https://github.com/lislema/nvidia-guardrails/blob/main/config/main.py): `config/main.py`
- [Incident check endpoint](https://github.com/lislema/nvidia-guardrails/blob/main/config/main.py): `config/main.py`

### Policy and rails

- [Jailbreak detection](https://github.com/lislema/nvidia-guardrails/blob/main/config/main.py): `config/main.py`
- [Semantic classification](https://github.com/lislema/nvidia-guardrails/blob/main/config/main.py): `config/main.py`
- [Keyword fallback](https://github.com/lislema/nvidia-guardrails/blob/main/config/main.py): `config/main.py`
- [Language policy config](https://github.com/lislema/nvidia-guardrails/blob/main/config/config.yaml): `config/config.yaml`
- [Colang rails](https://github.com/lislema/nvidia-guardrails/blob/main/rails/incident_rails.co): `rails/incident_rails.co`
- [Incident actions](https://github.com/lislema/nvidia-guardrails/blob/main/config/actions.py): `config/actions.py`

### AI response

- [IT support response](https://github.com/lislema/nvidia-guardrails/blob/main/config/main.py): `config/main.py`

### Other components

- **Incident reporter**
- **LLM provider**

## Connections

- Incident reporter → Streamlit app: submits message (evidence: `README.md`)
- Streamlit app → Translated labels: loads labels (evidence: `streamlit/app.py`)
- Streamlit app → Classify endpoint: POST /classify (evidence: `README.md`)
- Streamlit app → Incident check endpoint: POST /check (evidence: `README.md`)
- Incident check endpoint → Jailbreak detection: checks jailbreak (evidence: `config/main.py`)
- Classify endpoint → Jailbreak detection: checks jailbreak (evidence: `config/main.py`)
- Incident check endpoint → Semantic classification: classifies message (evidence: `README.md`)
- Classify endpoint → Semantic classification: classifies message (evidence: `config/main.py`)
- Classify endpoint → Keyword fallback: falls back (evidence: `config/main.py`)
- Incident check endpoint → Keyword fallback: checks keywords (evidence: `README.md`)
- Jailbreak detection → Language policy config: uses patterns (evidence: `README.md`)
- Keyword fallback → Language policy config: uses keywords (evidence: `README.md`)
- Incident check endpoint → IT support response: generates response (evidence: `README.md`)
- IT support response → LLM provider: requests completion (evidence: `README.md`)
- Incident check endpoint → Colang rails: loads flows (evidence: `config/main.py`)
- Colang rails → Incident actions: may invoke
