# harshsatbhai/guardrailx architecture

> Architecture diagram of the GitHub repository harshsatbhai/guardrailx, 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/harshsatbhai/guardrailx
- Repository: https://github.com/harshsatbhai/guardrailx

## Overview

This is a prompt-injection and jailbreak guardrail with a React chat/dashboard, Express orchestration and security controls, a Python ML service, and persistent logging. The main workflow classifies text or extracted media, blocks or warns by risk, sends allowed prompts to a selectable LLM, filters its response, and logs the outcome. Authenticated users can also manage chat sessions and view security analytics. Relationships are limited to those shown in excerpts, the source index, or README; several UI and route details are documented but not sampled.

Main entry points: [`backend/src/server.js`](https://github.com/harshsatbhai/guardrailx/blob/main/backend/src/server.js) (Express server), [`frontend/src/App.jsx`](https://github.com/harshsatbhai/guardrailx/blob/main/frontend/src/App.jsx) (App routing), [`backend/src/routes/pipelineShared.js`](https://github.com/harshsatbhai/guardrailx/blob/main/backend/src/routes/pipelineShared.js) (Post-classification), [`frontend/src/api.js`](https://github.com/harshsatbhai/guardrailx/blob/main/frontend/src/api.js) (Backend API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_app["App routing<br/>[App.jsx]"]
  node_authui["Auth UI<br/>[AuthPage.jsx]"]
  node_authstate["Auth state<br/>[AuthContext.jsx]"]
  node_chatui["Chat page<br/>[ChatPage.jsx]"]
  node_chatcomponents["Chat rendering<br/>[ChatMessage.jsx]"]
  node_voice["Voice input<br/>[useVoiceInput.js]"]
  node_sessions["Chat sessions<br/>[useChatSessions.js]"]
  node_dashboardui["Dashboard page<br/>[DashboardPage.jsx]"]
  node_api["Backend API client<br/>[api.js]"]
end

subgraph group_backend["Backend and security"]
  node_server["Express server<br/>[server.js]"]
  node_authroutes["Auth routes<br/>[auth.js]"]
  node_chatroutes["Chat routes<br/>[chats.js]"]
  node_promptentry["Prompt routes<br/>[checkPrompt.js]"]
  node_multimodalentry["Media routes<br/>[checkMultimodal.js]"]
  node_pipeline["Post-classification<br/>[pipelineShared.js]"]
  node_ratelimit["Rate and ban controls<br/>[rateLimiter.js]"]
  node_mlclient["ML service client<br/>[mlService.js]"]
  node_admin["Dashboard analytics<br/>[dashboard.js]"]
end

subgraph group_ml["ML guardrails"]
  node_mlapi["ML API<br/>[main.py]"]
  node_mediaextract["Media extraction<br/>[multimodal.py]"]
  node_classifier["Risk classifier<br/>[classify.py]"]
  node_features["NLP and features<br/>[features.py]"]
  node_filter["Response redaction<br/>[response_filter.py]"]
end

subgraph group_data["State and providers"]
  node_logs[("Prompt logs<br/>[PromptLog.js]")]
  node_chatstore[("Chat sessions store<br/>[ChatSession.js]")]
  node_userstore[("User store<br/>[User.js]")]
  node_blacklist[("IP blacklist<br/>[IpBlacklist.js]")]
  node_mongo[("MongoDB")]
  node_llm{{"LLM provider"}}
end

node_user(("User"))

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_chatui
node_app -->|"routes to"| node_dashboardui
node_app -->|"routes to"| node_authui
node_app -->|"provides auth"| node_authstate
node_app -->|"loads sessions"| node_sessions
node_chatui -->|"requests"| node_api
node_chatui -->|"renders"| node_chatcomponents
node_chatui -->|"uses"| node_voice
node_sessions -->|"loads and saves"| node_api
node_dashboardui -->|"requests"| node_api
node_authstate -->|"authenticates"| node_api
node_api -->|"calls API"| node_server
node_server -->|"mounts"| node_authroutes
node_server -->|"mounts"| node_chatroutes
node_server -->|"mounts"| node_promptentry
node_server -->|"mounts"| node_multimodalentry
node_server -->|"mounts"| node_admin
node_server -->|"guards prompt routes"| node_ratelimit
node_promptentry -->|"classifies prompt"| node_mlclient
node_multimodalentry -->|"classifies media"| node_mlclient
node_promptentry -->|"continues pipeline"| node_pipeline
node_multimodalentry -->|"continues pipeline"| node_pipeline
node_pipeline -->|"filters response"| node_mlclient
node_pipeline -->|"generates allowed response"| node_llm
node_pipeline -->|"records violation"| node_ratelimit
node_pipeline -->|"writes outcome"| node_logs
node_mlclient -->|"HTTP requests"| node_mlapi
node_mlapi -->|"classifies text"| node_classifier
node_mlapi -->|"filters output"| node_filter
node_mlapi -->|"extracts media text"| node_mediaextract
node_mediaextract -->|"sends extracted text"| node_classifier
node_classifier -->|"uses features"| node_features
node_authroutes -->|"uses accounts"| node_userstore
node_chatroutes -->|"uses sessions"| node_chatstore
node_admin -->|"reads analytics"| node_logs
node_admin -->|"manages bans"| node_blacklist
node_logs -.->|"persists in"| node_mongo
node_chatstore -.->|"persists in"| node_mongo
node_userstore -.->|"persists in"| node_mongo
node_blacklist -.->|"persists in"| node_mongo

click node_app "https://github.com/harshsatbhai/guardrailx/blob/main/frontend/src/App.jsx"
click node_authui "https://github.com/harshsatbhai/guardrailx/blob/main/frontend/src/pages/AuthPage.jsx"
click node_authstate "https://github.com/harshsatbhai/guardrailx/blob/main/frontend/src/context/AuthContext.jsx"
click node_chatui "https://github.com/harshsatbhai/guardrailx/blob/main/frontend/src/pages/ChatPage.jsx"
click node_chatcomponents "https://github.com/harshsatbhai/guardrailx/blob/main/frontend/src/components/ChatMessage.jsx"
click node_voice "https://github.com/harshsatbhai/guardrailx/blob/main/frontend/src/hooks/useVoiceInput.js"
click node_sessions "https://github.com/harshsatbhai/guardrailx/blob/main/frontend/src/hooks/useChatSessions.js"
click node_dashboardui "https://github.com/harshsatbhai/guardrailx/blob/main/frontend/src/pages/DashboardPage.jsx"
click node_api "https://github.com/harshsatbhai/guardrailx/blob/main/frontend/src/api.js"
click node_server "https://github.com/harshsatbhai/guardrailx/blob/main/backend/src/server.js"
click node_authroutes "https://github.com/harshsatbhai/guardrailx/blob/main/backend/src/routes/auth.js"
click node_chatroutes "https://github.com/harshsatbhai/guardrailx/blob/main/backend/src/routes/chats.js"
click node_promptentry "https://github.com/harshsatbhai/guardrailx/blob/main/backend/src/routes/checkPrompt.js"
click node_multimodalentry "https://github.com/harshsatbhai/guardrailx/blob/main/backend/src/routes/checkMultimodal.js"
click node_pipeline "https://github.com/harshsatbhai/guardrailx/blob/main/backend/src/routes/pipelineShared.js"
click node_ratelimit "https://github.com/harshsatbhai/guardrailx/blob/main/backend/src/middleware/rateLimiter.js"
click node_mlclient "https://github.com/harshsatbhai/guardrailx/blob/main/backend/src/services/mlService.js"
click node_mlapi "https://github.com/harshsatbhai/guardrailx/blob/main/ml-service/app/main.py"
click node_mediaextract "https://github.com/harshsatbhai/guardrailx/blob/main/ml-service/app/multimodal.py"
click node_classifier "https://github.com/harshsatbhai/guardrailx/blob/main/ml-service/app/classify.py"
click node_features "https://github.com/harshsatbhai/guardrailx/blob/main/ml-service/app/features.py"
click node_filter "https://github.com/harshsatbhai/guardrailx/blob/main/ml-service/app/response_filter.py"
click node_logs "https://github.com/harshsatbhai/guardrailx/blob/main/backend/src/models/PromptLog.js"
click node_chatstore "https://github.com/harshsatbhai/guardrailx/blob/main/backend/src/models/ChatSession.js"
click node_userstore "https://github.com/harshsatbhai/guardrailx/blob/main/backend/src/models/User.js"
click node_blacklist "https://github.com/harshsatbhai/guardrailx/blob/main/backend/src/models/IpBlacklist.js"
click node_admin "https://github.com/harshsatbhai/guardrailx/blob/main/backend/src/routes/dashboard.js"

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_app,node_authui,node_authstate,node_chatui,node_chatcomponents,node_voice,node_sessions,node_dashboardui,node_api,node_user toneBlue
class node_server,node_authroutes,node_chatroutes,node_promptentry,node_multimodalentry,node_pipeline,node_ratelimit,node_mlclient,node_admin toneAmber
class node_mlapi,node_mediaextract,node_classifier,node_features,node_filter toneMint
class node_logs,node_chatstore,node_userstore,node_blacklist,node_mongo,node_llm toneRose
```

## Components

### Web client

- [App routing](https://github.com/harshsatbhai/guardrailx/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Auth UI](https://github.com/harshsatbhai/guardrailx/blob/main/frontend/src/pages/AuthPage.jsx): `frontend/src/pages/AuthPage.jsx`
- [Auth state](https://github.com/harshsatbhai/guardrailx/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [Chat page](https://github.com/harshsatbhai/guardrailx/blob/main/frontend/src/pages/ChatPage.jsx): `frontend/src/pages/ChatPage.jsx`
- [Chat rendering](https://github.com/harshsatbhai/guardrailx/blob/main/frontend/src/components/ChatMessage.jsx): `frontend/src/components/ChatMessage.jsx`
- [Voice input](https://github.com/harshsatbhai/guardrailx/blob/main/frontend/src/hooks/useVoiceInput.js): `frontend/src/hooks/useVoiceInput.js`
- [Chat sessions](https://github.com/harshsatbhai/guardrailx/blob/main/frontend/src/hooks/useChatSessions.js): `frontend/src/hooks/useChatSessions.js`
- [Dashboard page](https://github.com/harshsatbhai/guardrailx/blob/main/frontend/src/pages/DashboardPage.jsx): `frontend/src/pages/DashboardPage.jsx`
- [Backend API client](https://github.com/harshsatbhai/guardrailx/blob/main/frontend/src/api.js): `frontend/src/api.js`

### Backend and security

- [Express server](https://github.com/harshsatbhai/guardrailx/blob/main/backend/src/server.js): `backend/src/server.js`
- [Auth routes](https://github.com/harshsatbhai/guardrailx/blob/main/backend/src/routes/auth.js): `backend/src/routes/auth.js`
- [Chat routes](https://github.com/harshsatbhai/guardrailx/blob/main/backend/src/routes/chats.js): `backend/src/routes/chats.js`
- [Prompt routes](https://github.com/harshsatbhai/guardrailx/blob/main/backend/src/routes/checkPrompt.js): `backend/src/routes/checkPrompt.js`
- [Media routes](https://github.com/harshsatbhai/guardrailx/blob/main/backend/src/routes/checkMultimodal.js): `backend/src/routes/checkMultimodal.js`
- [Post-classification](https://github.com/harshsatbhai/guardrailx/blob/main/backend/src/routes/pipelineShared.js): `backend/src/routes/pipelineShared.js`
- [Rate and ban controls](https://github.com/harshsatbhai/guardrailx/blob/main/backend/src/middleware/rateLimiter.js): `backend/src/middleware/rateLimiter.js`
- [ML service client](https://github.com/harshsatbhai/guardrailx/blob/main/backend/src/services/mlService.js): `backend/src/services/mlService.js`
- [Dashboard analytics](https://github.com/harshsatbhai/guardrailx/blob/main/backend/src/routes/dashboard.js): `backend/src/routes/dashboard.js`

### ML guardrails

- [ML API](https://github.com/harshsatbhai/guardrailx/blob/main/ml-service/app/main.py): `ml-service/app/main.py`
- [Media extraction](https://github.com/harshsatbhai/guardrailx/blob/main/ml-service/app/multimodal.py): `ml-service/app/multimodal.py`
- [Risk classifier](https://github.com/harshsatbhai/guardrailx/blob/main/ml-service/app/classify.py): `ml-service/app/classify.py`
- [NLP and features](https://github.com/harshsatbhai/guardrailx/blob/main/ml-service/app/features.py): `ml-service/app/features.py`
- [Response redaction](https://github.com/harshsatbhai/guardrailx/blob/main/ml-service/app/response_filter.py): `ml-service/app/response_filter.py`

### State and providers

- [Prompt logs](https://github.com/harshsatbhai/guardrailx/blob/main/backend/src/models/PromptLog.js): `backend/src/models/PromptLog.js`
- [Chat sessions store](https://github.com/harshsatbhai/guardrailx/blob/main/backend/src/models/ChatSession.js): `backend/src/models/ChatSession.js`
- [User store](https://github.com/harshsatbhai/guardrailx/blob/main/backend/src/models/User.js): `backend/src/models/User.js`
- [IP blacklist](https://github.com/harshsatbhai/guardrailx/blob/main/backend/src/models/IpBlacklist.js): `backend/src/models/IpBlacklist.js`
- **MongoDB**
- **LLM provider**

### Other components

- **User**

## Connections

- User → App routing: uses (evidence: `README.md`)
- App routing → Chat page: routes to (evidence: `frontend/src/App.jsx`)
- App routing → Dashboard page: routes to (evidence: `frontend/src/App.jsx`)
- App routing → Auth UI: routes to (evidence: `frontend/src/App.jsx`)
- App routing → Auth state: provides auth (evidence: `frontend/src/App.jsx`)
- App routing → Chat sessions: loads sessions (evidence: `frontend/src/App.jsx`)
- Chat page → Backend API client: requests (evidence: `frontend/src/pages/ChatPage.jsx`)
- Chat page → Chat rendering: renders (evidence: `frontend/src/pages/ChatPage.jsx`)
- Chat page → Voice input: uses (evidence: `frontend/src/pages/ChatPage.jsx`)
- Chat sessions → Backend API client: loads and saves (evidence: `frontend/src/hooks/useChatSessions.js`)
- Dashboard page → Backend API client: requests (evidence: `frontend/src/pages/DashboardPage.jsx`)
- Auth state → Backend API client: authenticates (evidence: `frontend/src/context/AuthContext.jsx`)
- Backend API client → Express server: calls API (evidence: `README.md`)
- Express server → Auth routes: mounts (evidence: `backend/src/server.js`)
- Express server → Chat routes: mounts (evidence: `backend/src/server.js`)
- Express server → Prompt routes: mounts (evidence: `backend/src/server.js`)
- Express server → Media routes: mounts (evidence: `backend/src/server.js`)
- Express server → Dashboard analytics: mounts (evidence: `backend/src/server.js`)
- Express server → Rate and ban controls: guards prompt routes (evidence: `backend/src/server.js`)
- Prompt routes → ML service client: classifies prompt (evidence: `README.md`)
- Media routes → ML service client: classifies media (evidence: `backend/src/routes/checkMultimodal.js`)
- Prompt routes → Post-classification: continues pipeline (evidence: `backend/src/routes/pipelineShared.js`)
- Media routes → Post-classification: continues pipeline (evidence: `backend/src/routes/checkMultimodal.js`)
- Post-classification → ML service client: filters response (evidence: `backend/src/routes/pipelineShared.js`)
- Post-classification → LLM provider: generates allowed response (evidence: `backend/src/routes/pipelineShared.js`)
- Post-classification → Rate and ban controls: records violation (evidence: `backend/src/routes/pipelineShared.js`)
- Post-classification → Prompt logs: writes outcome (evidence: `backend/src/routes/pipelineShared.js`)
- ML service client → ML API: HTTP requests (evidence: `backend/src/services/mlService.js`)
- ML API → Risk classifier: classifies text (evidence: `ml-service/app/main.py`)
- ML API → Response redaction: filters output (evidence: `ml-service/app/main.py`)
- ML API → Media extraction: extracts media text (evidence: `ml-service/app/main.py`)
- Media extraction → Risk classifier: sends extracted text (evidence: `ml-service/app/main.py`)
- Risk classifier → NLP and features: uses features (evidence: `ml-service/app/classify.py`)
- Auth routes → User store: uses accounts (evidence: `backend/src/routes/auth.js`)
- Chat routes → Chat sessions store: uses sessions (evidence: `backend/src/routes/chats.js`)
- Dashboard analytics → Prompt logs: reads analytics (evidence: `backend/src/routes/dashboard.js`)
- Dashboard analytics → IP blacklist: manages bans (evidence: `backend/src/routes/dashboard.js`)
- Prompt logs → MongoDB: persists in
- Chat sessions store → MongoDB: persists in
- User store → MongoDB: persists in
- IP blacklist → MongoDB: persists in
