# priyanshumnnit01/ai-voice-assistant architecture

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

- Interactive diagram: https://gitdiagram.com/priyanshumnnit01/ai-voice-assistant
- Repository: https://github.com/priyanshumnnit01/ai-voice-assistant

## Overview

This is a web-based AI voice assistant with account management, assistant customization, and natural-language commands. Users sign in, configure an assistant, then submit commands through the home experience; the server interprets commands, handles supported actions such as date/time responses and email, and returns results. The graph includes documented Google sign-in and mail capabilities, but those implementations were not fully sampled. Edges reflect shown calls, mounts, or frontend requests; unsampled subsystem internals are left unspecified.

Main entry points: [`client/src/App.jsx`](https://github.com/priyanshumnnit01/ai-voice-assistant/blob/main/client/src/App.jsx) (App routes), [`server/controller/user.controller.js`](https://github.com/priyanshumnnit01/ai-voice-assistant/blob/main/server/controller/user.controller.js) (Assistant API), [`client/src/context/UserContext.jsx`](https://github.com/priyanshumnnit01/ai-voice-assistant/blob/main/client/src/context/UserContext.jsx) (User context), [`server/index.js`](https://github.com/priyanshumnnit01/ai-voice-assistant/blob/main/server/index.js) (Express app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_app["App routes<br/>[App.jsx]"]
  node_user_context["User context<br/>[UserContext.jsx]"]
  node_home["Assistant home<br/>[Home.jsx]"]
  node_customize["Assistant setup<br/>[Customize.jsx]"]
  node_customize2["Setup continuation<br/>[Customize2.jsx]"]
  node_auth_ui["Login and signup<br/>[Login.jsx]"]
  node_card["Assistant card<br/>[Card.jsx]"]
end

subgraph group_server["API and identity"]
  node_server["Express app<br/>[index.js]"]
  node_auth_routes["Auth routes<br/>[auth.route.js]"]
  node_auth_controller["Account operations<br/>[auth.controller.js]"]
  node_user_routes["User routes<br/>[user.route.js]"]
  node_auth_guard["Cookie auth<br/>[isAuth.js]"]
  node_google_auth["Google sign-in<br/>[google.route.js]"]
  node_passport["Passport strategy<br/>[passport.js]"]
end

subgraph group_assistant["Assistant actions"]
  node_user_controller["Assistant API<br/>[user.controller.js]"]
  node_language_model["Command interpretation<br/>[gemini.js]"]
  node_mail_sender["Email delivery<br/>[sendMail.js]"]
end

subgraph group_data["Persistence and integrations"]
  node_user_model[("User records<br/>[user.model.js]")]
  node_token["JWT generation<br/>[token.js]"]
  node_cloudinary["Image hosting<br/>[cloudinary.js]"]
end

node_visitor(("User"))
node_database[("MongoDB")]
node_groq["Groq API"]
node_gmail["Gmail API"]
node_image_service["Cloudinary service"]

node_visitor -->|"uses"| node_app
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_auth_ui
node_app -->|"routes to"| node_customize
node_app -->|"routes to"| node_customize2
node_app -->|"reads state"| node_user_context
node_customize -->|"renders"| node_card
node_home -->|"uses state"| node_user_context
node_auth_ui -->|"uses state"| node_user_context
node_customize -->|"uses state"| node_user_context
node_user_context -->|"requests current user and commands"| node_user_routes
node_server -->|"mounts"| node_auth_routes
node_server -->|"mounts"| node_user_routes
node_server -->|"mounts"| node_google_auth
node_server -->|"configures"| node_passport
node_auth_routes -->|"dispatches"| node_auth_controller
node_auth_controller -->|"reads and writes"| node_user_model
node_auth_controller -->|"creates token"| node_token
node_user_routes -->|"dispatches"| node_user_controller
node_user_routes -->|"guards requests"| node_auth_guard
node_user_controller -->|"reads and updates"| node_user_model
node_user_controller -->|"interprets command"| node_language_model
node_user_controller -->|"sends email"| node_mail_sender
node_user_controller -->|"uploads image"| node_cloudinary
node_language_model -->|"requests completion"| node_groq
node_mail_sender -->|"loads credentials"| node_user_model
node_mail_sender -->|"sends message"| node_gmail
node_cloudinary -.->|"uploads asset"| node_image_service
node_user_model -.->|"persists records"| node_database
node_google_auth -.->|"uses strategy"| node_passport

click node_app "https://github.com/priyanshumnnit01/ai-voice-assistant/blob/main/client/src/App.jsx"
click node_user_context "https://github.com/priyanshumnnit01/ai-voice-assistant/blob/main/client/src/context/UserContext.jsx"
click node_home "https://github.com/priyanshumnnit01/ai-voice-assistant/blob/main/client/src/pages/Home.jsx"
click node_customize "https://github.com/priyanshumnnit01/ai-voice-assistant/blob/main/client/src/pages/Customize.jsx"
click node_customize2 "https://github.com/priyanshumnnit01/ai-voice-assistant/blob/main/client/src/pages/Customize2.jsx"
click node_auth_ui "https://github.com/priyanshumnnit01/ai-voice-assistant/blob/main/client/src/pages/Login.jsx"
click node_card "https://github.com/priyanshumnnit01/ai-voice-assistant/blob/main/client/src/components/Card.jsx"
click node_server "https://github.com/priyanshumnnit01/ai-voice-assistant/blob/main/server/index.js"
click node_auth_routes "https://github.com/priyanshumnnit01/ai-voice-assistant/blob/main/server/routes/auth.route.js"
click node_auth_controller "https://github.com/priyanshumnnit01/ai-voice-assistant/blob/main/server/controller/auth.controller.js"
click node_user_routes "https://github.com/priyanshumnnit01/ai-voice-assistant/blob/main/server/routes/user.route.js"
click node_auth_guard "https://github.com/priyanshumnnit01/ai-voice-assistant/blob/main/server/middleware/isAuth.js"
click node_google_auth "https://github.com/priyanshumnnit01/ai-voice-assistant/blob/main/server/routes/google.route.js"
click node_passport "https://github.com/priyanshumnnit01/ai-voice-assistant/blob/main/server/config/passport.js"
click node_user_controller "https://github.com/priyanshumnnit01/ai-voice-assistant/blob/main/server/controller/user.controller.js"
click node_language_model "https://github.com/priyanshumnnit01/ai-voice-assistant/blob/main/server/gemini.js"
click node_mail_sender "https://github.com/priyanshumnnit01/ai-voice-assistant/blob/main/server/mcp/sendMail.js"
click node_user_model "https://github.com/priyanshumnnit01/ai-voice-assistant/blob/main/server/models/user.model.js"
click node_token "https://github.com/priyanshumnnit01/ai-voice-assistant/blob/main/server/config/token.js"
click node_cloudinary "https://github.com/priyanshumnnit01/ai-voice-assistant/blob/main/server/config/cloudinary.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_user_context,node_home,node_customize,node_customize2,node_auth_ui,node_card,node_visitor toneBlue
class node_server,node_auth_routes,node_auth_controller,node_user_routes,node_auth_guard,node_google_auth,node_passport,node_database toneAmber
class node_user_controller,node_language_model,node_mail_sender,node_groq,node_gmail toneMint
class node_user_model,node_token,node_cloudinary toneRose
class node_image_service toneIndigo
```

## Components

### Web client

- [App routes](https://github.com/priyanshumnnit01/ai-voice-assistant/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [User context](https://github.com/priyanshumnnit01/ai-voice-assistant/blob/main/client/src/context/UserContext.jsx): `client/src/context/UserContext.jsx`
- [Assistant home](https://github.com/priyanshumnnit01/ai-voice-assistant/blob/main/client/src/pages/Home.jsx): `client/src/pages/Home.jsx`
- [Assistant setup](https://github.com/priyanshumnnit01/ai-voice-assistant/blob/main/client/src/pages/Customize.jsx): `client/src/pages/Customize.jsx`
- [Setup continuation](https://github.com/priyanshumnnit01/ai-voice-assistant/blob/main/client/src/pages/Customize2.jsx): `client/src/pages/Customize2.jsx`
- [Login and signup](https://github.com/priyanshumnnit01/ai-voice-assistant/blob/main/client/src/pages/Login.jsx): `client/src/pages/Login.jsx`
- [Assistant card](https://github.com/priyanshumnnit01/ai-voice-assistant/blob/main/client/src/components/Card.jsx): `client/src/components/Card.jsx`

### API and identity

- [Express app](https://github.com/priyanshumnnit01/ai-voice-assistant/blob/main/server/index.js): `server/index.js`
- [Auth routes](https://github.com/priyanshumnnit01/ai-voice-assistant/blob/main/server/routes/auth.route.js): `server/routes/auth.route.js`
- [Account operations](https://github.com/priyanshumnnit01/ai-voice-assistant/blob/main/server/controller/auth.controller.js): `server/controller/auth.controller.js`
- [User routes](https://github.com/priyanshumnnit01/ai-voice-assistant/blob/main/server/routes/user.route.js): `server/routes/user.route.js`
- [Cookie auth](https://github.com/priyanshumnnit01/ai-voice-assistant/blob/main/server/middleware/isAuth.js): `server/middleware/isAuth.js`
- [Google sign-in](https://github.com/priyanshumnnit01/ai-voice-assistant/blob/main/server/routes/google.route.js): `server/routes/google.route.js`
- [Passport strategy](https://github.com/priyanshumnnit01/ai-voice-assistant/blob/main/server/config/passport.js): `server/config/passport.js`

### Assistant actions

- [Assistant API](https://github.com/priyanshumnnit01/ai-voice-assistant/blob/main/server/controller/user.controller.js): `server/controller/user.controller.js`
- [Command interpretation](https://github.com/priyanshumnnit01/ai-voice-assistant/blob/main/server/gemini.js): `server/gemini.js`
- [Email delivery](https://github.com/priyanshumnnit01/ai-voice-assistant/blob/main/server/mcp/sendMail.js): `server/mcp/sendMail.js`

### Persistence and integrations

- [User records](https://github.com/priyanshumnnit01/ai-voice-assistant/blob/main/server/models/user.model.js): `server/models/user.model.js`
- [JWT generation](https://github.com/priyanshumnnit01/ai-voice-assistant/blob/main/server/config/token.js): `server/config/token.js`
- [Image hosting](https://github.com/priyanshumnnit01/ai-voice-assistant/blob/main/server/config/cloudinary.js): `server/config/cloudinary.js`

### Other components

- **User**
- **MongoDB**
- **Groq API**
- **Gmail API**
- **Cloudinary service**

## Connections

- User → App routes: uses
- App routes → Assistant home: routes to (evidence: `client/src/App.jsx`)
- App routes → Login and signup: routes to (evidence: `client/src/App.jsx`)
- App routes → Assistant setup: routes to (evidence: `client/src/App.jsx`)
- App routes → Setup continuation: routes to (evidence: `client/src/App.jsx`)
- App routes → User context: reads state (evidence: `client/src/App.jsx`)
- Assistant setup → Assistant card: renders (evidence: `client/src/pages/Customize.jsx`)
- Assistant home → User context: uses state (evidence: `client/src/pages/Home.jsx`)
- Login and signup → User context: uses state (evidence: `client/src/pages/Login.jsx`)
- Assistant setup → User context: uses state (evidence: `client/src/pages/Customize.jsx`)
- User context → User routes: requests current user and commands (evidence: `client/src/context/UserContext.jsx`)
- Express app → Auth routes: mounts (evidence: `server/index.js`)
- Express app → User routes: mounts (evidence: `server/index.js`)
- Express app → Google sign-in: mounts (evidence: `server/index.js`)
- Express app → Passport strategy: configures (evidence: `server/index.js`)
- Auth routes → Account operations: dispatches (evidence: `server/routes/auth.route.js`)
- Account operations → User records: reads and writes (evidence: `server/controller/auth.controller.js`)
- Account operations → JWT generation: creates token (evidence: `server/controller/auth.controller.js`)
- User routes → Assistant API: dispatches (evidence: `server/routes/user.route.js`)
- User routes → Cookie auth: guards requests (evidence: `server/routes/user.route.js`)
- Assistant API → User records: reads and updates (evidence: `server/controller/user.controller.js`)
- Assistant API → Command interpretation: interprets command (evidence: `server/controller/user.controller.js`)
- Assistant API → Email delivery: sends email (evidence: `server/controller/user.controller.js`)
- Assistant API → Image hosting: uploads image (evidence: `server/controller/user.controller.js`)
- Command interpretation → Groq API: requests completion (evidence: `server/gemini.js`)
- Email delivery → User records: loads credentials (evidence: `server/mcp/sendMail.js`)
- Email delivery → Gmail API: sends message (evidence: `server/mcp/sendMail.js`)
- Image hosting → Cloudinary service: uploads asset
- User records → MongoDB: persists records
- Google sign-in → Passport strategy: uses strategy
