# sakamuriajithsai09-png/jarvis-ai-assistant architecture

> Architecture diagram of the GitHub repository sakamuriajithsai09-png/jarvis-ai-assistant, 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/sakamuriajithsai09-png/jarvis-ai-assistant
- Repository: https://github.com/sakamuriajithsai09-png/jarvis-ai-assistant

## Overview

JARVIS is a browser-based personal AI assistant: signed-in users chat by text or voice, receive Gemini responses, and can manage conversation history, saved memory, settings, tools, automation, and system status. The main chat route coordinates authentication, speech input, AI requests, and local/cloud chat synchronization; the server handles chat requests and the AI handler loads private memory before calling Gemini. The README describes broader planned capabilities, but the sampled code does not establish tool execution or automation behavior. Edges reflect excerpts, source-index references, or README claims; unsampled route internals are represented conservatively.

Main entry points: [`src/routes/index.tsx`](https://github.com/sakamuriajithsai09-png/jarvis-ai-assistant/blob/main/src/routes/index.tsx) (Chat Dashboard), [`src/routeTree.gen.ts`](https://github.com/sakamuriajithsai09-png/jarvis-ai-assistant/blob/main/src/routeTree.gen.ts) (Route Registry), [`src/components/jarvis/Shell.tsx`](https://github.com/sakamuriajithsai09-png/jarvis-ai-assistant/blob/main/src/components/jarvis/Shell.tsx) (Navigation Shell), [`src/lib/ai/jarvis-ai.ts`](https://github.com/sakamuriajithsai09-png/jarvis-ai-assistant/blob/main/src/lib/ai/jarvis-ai.ts) (Chat Handler)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Assistant UI"]
  node_routes["Route Registry<br/>[routeTree.gen.ts]"]
  node_shell["Navigation Shell<br/>[Shell.tsx]"]
  node_orb["AI Orb<br/>[Orb.tsx]"]
end

subgraph group_experience["User Features"]
  node_dashboard["Chat Dashboard<br/>[index.tsx]"]
  node_voice["Voice I/O<br/>[voice.ts]"]
  node_history["Conversation History<br/>[history.tsx]"]
  node_memory["Memory Manager<br/>[memory.tsx]"]
  node_settings["Assistant Settings<br/>[settings.tsx]"]
  node_tools["Connected Tools<br/>[tools.tsx]"]
  node_automation["Automation Center<br/>[automation.tsx]"]
  node_status["System Status<br/>[status.tsx]"]
end

subgraph group_persistence["Identity &amp; Data"]
  node_localstore[("Local Cache<br/>[jarvis-store.ts]")]
  node_auth["Authentication<br/>[auth.ts]"]
  node_supabaseclient["Browser Supabase Client<br/>[client.ts]"]
  node_sync["Cloud Sync<br/>[cloud-sync.ts]"]
  node_cloud["Cloud Data Access<br/>[cloud.ts]"]
  node_serverclient["Server Supabase Client<br/>[server.ts]"]
end

subgraph group_intelligence["AI Services"]
  node_serverentry["Request Server<br/>[server.ts]"]
  node_chathandler["Chat Handler<br/>[jarvis-ai.ts]"]
  node_geminifunction["Gemini Edge Function<br/>[index.ts]"]
  node_geminishared["Gemini Client<br/>[gemini.ts]"]
end

node_user(("User"))
node_supabase[("Supabase")]
node_gemini{{"Gemini API"}}

node_user -->|"opens app"| node_routes
node_routes -->|"routes to"| node_dashboard
node_routes -->|"routes to"| node_history
node_routes -->|"routes to"| node_memory
node_routes -->|"routes to"| node_settings
node_routes -->|"routes to"| node_tools
node_routes -->|"routes to"| node_automation
node_routes -->|"routes to"| node_status
node_user -->|"navigates"| node_shell
node_dashboard -->|"renders"| node_shell
node_dashboard -->|"renders"| node_orb
node_dashboard -->|"checks session"| node_auth
node_dashboard -->|"captures speech"| node_voice
node_voice -->|"submits transcript"| node_dashboard
node_dashboard -->|"requests reply"| node_chathandler
node_dashboard -->|"stores chat"| node_localstore
node_dashboard -->|"syncs chat"| node_sync
node_history -->|"renders"| node_shell
node_history -->|"uses cache"| node_localstore
node_history -->|"loads cloud data"| node_cloud
node_memory -->|"renders"| node_shell
node_memory -->|"uses cache"| node_localstore
node_memory -->|"manages memories"| node_cloud
node_settings -->|"renders"| node_shell
node_settings -->|"uses settings"| node_localstore
node_settings -->|"configures voice"| node_voice
node_status -->|"renders"| node_shell
node_status -->|"checks AI service"| node_chathandler
node_sync -->|"merges cache"| node_localstore
node_sync -->|"gets identity"| node_auth
node_sync -->|"uses cloud access"| node_cloud
node_cloud -->|"creates client"| node_serverclient
node_auth -->|"creates client"| node_serverclient
node_serverclient -->|"authenticates"| node_supabase
node_supabaseclient -->|"connects"| node_supabase
node_serverentry -->|"dispatches chat"| node_chathandler
node_chathandler -->|"loads private memory"| node_supabase
node_chathandler -->|"requests generation"| node_gemini
node_geminifunction -->|"uses client"| node_geminishared
node_geminifunction -.->|"requests generation"| node_gemini
node_dashboard -.->|"may invoke"| node_geminifunction

click node_routes "https://github.com/sakamuriajithsai09-png/jarvis-ai-assistant/blob/main/src/routeTree.gen.ts"
click node_shell "https://github.com/sakamuriajithsai09-png/jarvis-ai-assistant/blob/main/src/components/jarvis/Shell.tsx"
click node_dashboard "https://github.com/sakamuriajithsai09-png/jarvis-ai-assistant/blob/main/src/routes/index.tsx"
click node_orb "https://github.com/sakamuriajithsai09-png/jarvis-ai-assistant/blob/main/src/components/jarvis/Orb.tsx"
click node_voice "https://github.com/sakamuriajithsai09-png/jarvis-ai-assistant/blob/main/src/lib/voice.ts"
click node_history "https://github.com/sakamuriajithsai09-png/jarvis-ai-assistant/blob/main/src/routes/history.tsx"
click node_memory "https://github.com/sakamuriajithsai09-png/jarvis-ai-assistant/blob/main/src/routes/memory.tsx"
click node_settings "https://github.com/sakamuriajithsai09-png/jarvis-ai-assistant/blob/main/src/routes/settings.tsx"
click node_tools "https://github.com/sakamuriajithsai09-png/jarvis-ai-assistant/blob/main/src/routes/tools.tsx"
click node_automation "https://github.com/sakamuriajithsai09-png/jarvis-ai-assistant/blob/main/src/routes/automation.tsx"
click node_status "https://github.com/sakamuriajithsai09-png/jarvis-ai-assistant/blob/main/src/routes/status.tsx"
click node_localstore "https://github.com/sakamuriajithsai09-png/jarvis-ai-assistant/blob/main/src/lib/jarvis-store.ts"
click node_auth "https://github.com/sakamuriajithsai09-png/jarvis-ai-assistant/blob/main/src/lib/supabase/auth.ts"
click node_supabaseclient "https://github.com/sakamuriajithsai09-png/jarvis-ai-assistant/blob/main/src/lib/supabase/client.ts"
click node_sync "https://github.com/sakamuriajithsai09-png/jarvis-ai-assistant/blob/main/src/lib/supabase/cloud-sync.ts"
click node_cloud "https://github.com/sakamuriajithsai09-png/jarvis-ai-assistant/blob/main/src/lib/supabase/cloud.ts"
click node_serverentry "https://github.com/sakamuriajithsai09-png/jarvis-ai-assistant/blob/main/src/server.ts"
click node_chathandler "https://github.com/sakamuriajithsai09-png/jarvis-ai-assistant/blob/main/src/lib/ai/jarvis-ai.ts"
click node_geminifunction "https://github.com/sakamuriajithsai09-png/jarvis-ai-assistant/blob/main/supabase/functions/jarvis-chat/index.ts"
click node_geminishared "https://github.com/sakamuriajithsai09-png/jarvis-ai-assistant/blob/main/supabase/functions/_shared/gemini.ts"
click node_serverclient "https://github.com/sakamuriajithsai09-png/jarvis-ai-assistant/blob/main/src/lib/supabase/server.ts"

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_routes,node_shell,node_orb,node_user toneBlue
class node_dashboard,node_voice,node_history,node_memory,node_settings,node_tools,node_automation,node_status,node_supabase toneAmber
class node_localstore,node_auth,node_supabaseclient,node_sync,node_cloud,node_serverclient,node_gemini toneMint
class node_serverentry,node_chathandler,node_geminifunction,node_geminishared toneRose
```

## Components

### Assistant UI

- [Route Registry](https://github.com/sakamuriajithsai09-png/jarvis-ai-assistant/blob/main/src/routeTree.gen.ts): `src/routeTree.gen.ts`
- [Navigation Shell](https://github.com/sakamuriajithsai09-png/jarvis-ai-assistant/blob/main/src/components/jarvis/Shell.tsx): `src/components/jarvis/Shell.tsx`
- [AI Orb](https://github.com/sakamuriajithsai09-png/jarvis-ai-assistant/blob/main/src/components/jarvis/Orb.tsx): `src/components/jarvis/Orb.tsx`

### User Features

- [Chat Dashboard](https://github.com/sakamuriajithsai09-png/jarvis-ai-assistant/blob/main/src/routes/index.tsx): `src/routes/index.tsx`
- [Voice I/O](https://github.com/sakamuriajithsai09-png/jarvis-ai-assistant/blob/main/src/lib/voice.ts): `src/lib/voice.ts`
- [Conversation History](https://github.com/sakamuriajithsai09-png/jarvis-ai-assistant/blob/main/src/routes/history.tsx): `src/routes/history.tsx`
- [Memory Manager](https://github.com/sakamuriajithsai09-png/jarvis-ai-assistant/blob/main/src/routes/memory.tsx): `src/routes/memory.tsx`
- [Assistant Settings](https://github.com/sakamuriajithsai09-png/jarvis-ai-assistant/blob/main/src/routes/settings.tsx): `src/routes/settings.tsx`
- [Connected Tools](https://github.com/sakamuriajithsai09-png/jarvis-ai-assistant/blob/main/src/routes/tools.tsx): `src/routes/tools.tsx`
- [Automation Center](https://github.com/sakamuriajithsai09-png/jarvis-ai-assistant/blob/main/src/routes/automation.tsx): `src/routes/automation.tsx`
- [System Status](https://github.com/sakamuriajithsai09-png/jarvis-ai-assistant/blob/main/src/routes/status.tsx): `src/routes/status.tsx`

### Identity & Data

- [Local Cache](https://github.com/sakamuriajithsai09-png/jarvis-ai-assistant/blob/main/src/lib/jarvis-store.ts): `src/lib/jarvis-store.ts`
- [Authentication](https://github.com/sakamuriajithsai09-png/jarvis-ai-assistant/blob/main/src/lib/supabase/auth.ts): `src/lib/supabase/auth.ts`
- [Browser Supabase Client](https://github.com/sakamuriajithsai09-png/jarvis-ai-assistant/blob/main/src/lib/supabase/client.ts): `src/lib/supabase/client.ts`
- [Cloud Sync](https://github.com/sakamuriajithsai09-png/jarvis-ai-assistant/blob/main/src/lib/supabase/cloud-sync.ts): `src/lib/supabase/cloud-sync.ts`
- [Cloud Data Access](https://github.com/sakamuriajithsai09-png/jarvis-ai-assistant/blob/main/src/lib/supabase/cloud.ts): `src/lib/supabase/cloud.ts`
- [Server Supabase Client](https://github.com/sakamuriajithsai09-png/jarvis-ai-assistant/blob/main/src/lib/supabase/server.ts): `src/lib/supabase/server.ts`

### AI Services

- [Request Server](https://github.com/sakamuriajithsai09-png/jarvis-ai-assistant/blob/main/src/server.ts): `src/server.ts`
- [Chat Handler](https://github.com/sakamuriajithsai09-png/jarvis-ai-assistant/blob/main/src/lib/ai/jarvis-ai.ts): `src/lib/ai/jarvis-ai.ts`
- [Gemini Edge Function](https://github.com/sakamuriajithsai09-png/jarvis-ai-assistant/blob/main/supabase/functions/jarvis-chat/index.ts): `supabase/functions/jarvis-chat/index.ts`
- [Gemini Client](https://github.com/sakamuriajithsai09-png/jarvis-ai-assistant/blob/main/supabase/functions/_shared/gemini.ts): `supabase/functions/_shared/gemini.ts`

### Other components

- **User**
- **Supabase**
- **Gemini API**

## Connections

- User → Route Registry: opens app (evidence: `src/routeTree.gen.ts`)
- Route Registry → Chat Dashboard: routes to (evidence: `src/routeTree.gen.ts`)
- Route Registry → Conversation History: routes to (evidence: `src/routeTree.gen.ts`)
- Route Registry → Memory Manager: routes to (evidence: `src/routeTree.gen.ts`)
- Route Registry → Assistant Settings: routes to (evidence: `src/routeTree.gen.ts`)
- Route Registry → Connected Tools: routes to (evidence: `src/routeTree.gen.ts`)
- Route Registry → Automation Center: routes to (evidence: `src/routeTree.gen.ts`)
- Route Registry → System Status: routes to (evidence: `src/routeTree.gen.ts`)
- User → Navigation Shell: navigates (evidence: `src/components/jarvis/Shell.tsx`)
- Chat Dashboard → Navigation Shell: renders (evidence: `src/routes/index.tsx`)
- Chat Dashboard → AI Orb: renders (evidence: `src/routes/index.tsx`)
- Chat Dashboard → Authentication: checks session (evidence: `src/routes/index.tsx`)
- Chat Dashboard → Voice I/O: captures speech (evidence: `src/routes/index.tsx`)
- Voice I/O → Chat Dashboard: submits transcript (evidence: `src/routes/index.tsx`)
- Chat Dashboard → Chat Handler: requests reply (evidence: `src/routes/index.tsx`)
- Chat Dashboard → Local Cache: stores chat (evidence: `src/routes/index.tsx`)
- Chat Dashboard → Cloud Sync: syncs chat (evidence: `src/routes/index.tsx`)
- Conversation History → Navigation Shell: renders (evidence: `src/routes/history.tsx`)
- Conversation History → Local Cache: uses cache (evidence: `src/routes/history.tsx`)
- Conversation History → Cloud Data Access: loads cloud data (evidence: `src/routes/history.tsx`)
- Memory Manager → Navigation Shell: renders (evidence: `src/routes/memory.tsx`)
- Memory Manager → Local Cache: uses cache (evidence: `src/routes/memory.tsx`)
- Memory Manager → Cloud Data Access: manages memories (evidence: `src/routes/memory.tsx`)
- Assistant Settings → Navigation Shell: renders (evidence: `src/routes/settings.tsx`)
- Assistant Settings → Local Cache: uses settings (evidence: `src/routes/settings.tsx`)
- Assistant Settings → Voice I/O: configures voice (evidence: `src/routes/settings.tsx`)
- System Status → Navigation Shell: renders (evidence: `src/routes/status.tsx`)
- System Status → Chat Handler: checks AI service (evidence: `src/routes/status.tsx`)
- Cloud Sync → Local Cache: merges cache (evidence: `src/lib/supabase/cloud-sync.ts`)
- Cloud Sync → Authentication: gets identity (evidence: `src/lib/supabase/cloud-sync.ts`)
- Cloud Sync → Cloud Data Access: uses cloud access (evidence: `src/lib/supabase/cloud-sync.ts`)
- Cloud Data Access → Server Supabase Client: creates client (evidence: `src/lib/supabase/cloud.ts`)
- Authentication → Server Supabase Client: creates client (evidence: `src/lib/supabase/auth.ts`)
- Server Supabase Client → Supabase: authenticates (evidence: `src/lib/supabase/server.ts`)
- Browser Supabase Client → Supabase: connects (evidence: `src/lib/supabase/client.ts`)
- Request Server → Chat Handler: dispatches chat (evidence: `src/server.ts`)
- Chat Handler → Supabase: loads private memory (evidence: `src/lib/ai/jarvis-ai.ts`)
- Chat Handler → Gemini API: requests generation (evidence: `src/lib/ai/jarvis-ai.ts`)
- Gemini Edge Function → Gemini Client: uses client (evidence: `supabase/functions/jarvis-chat/index.ts`)
- Gemini Edge Function → Gemini API: requests generation
- Chat Dashboard → Gemini Edge Function: may invoke
