# akhilchiluvari/project-jarvis architecture

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

## Overview

JARVIS OS is represented here as a FastAPI chat-streaming backend. The visible workflow accepts a chat request, passes its message and session ID to the agent, and emits agent tokens and tool-status events as server-sent events. The backend also checks Redis at startup, but the excerpt does not show chat state being stored there. The frontend and agent implementation are not excerpted, so their internal behavior and wiring to external model services cannot be confirmed.

Main entry points: [`services/core-backend/main.py`](https://github.com/akhilchiluvari/project-jarvis/blob/main/services/core-backend/main.py) (Chat stream API), [`apps/frontend`](https://github.com/akhilchiluvari/project-jarvis/tree/main/apps/frontend) (Frontend app), [`services/core-backend/agent.py`](https://github.com/akhilchiluvari/project-jarvis/blob/main/services/core-backend/agent.py) (Agent)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_chat["Chat runtime"]
  node_frontend["Frontend app"]
  node_chat_api["Chat stream API<br/>[main.py]"]
  node_agent["Agent<br/>[agent.py]"]
end

subgraph group_state["State infrastructure"]
  node_redis[("Redis")]
end

node_user(("Chat client"))

node_user -.->|"uses"| node_frontend
node_frontend -.->|"submits chat"| node_chat_api
node_chat_api -->|"runs agent"| node_agent
node_chat_api -->|"checks connection"| node_redis

click node_frontend "https://github.com/akhilchiluvari/project-jarvis/tree/main/apps/frontend"
click node_chat_api "https://github.com/akhilchiluvari/project-jarvis/blob/main/services/core-backend/main.py"
click node_agent "https://github.com/akhilchiluvari/project-jarvis/blob/main/services/core-backend/agent.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_frontend,node_chat_api,node_agent,node_user toneBlue
class node_redis toneAmber
```

## Components

### Chat runtime

- [Frontend app](https://github.com/akhilchiluvari/project-jarvis/tree/main/apps/frontend): `apps/frontend`
- [Chat stream API](https://github.com/akhilchiluvari/project-jarvis/blob/main/services/core-backend/main.py): `services/core-backend/main.py`
- [Agent](https://github.com/akhilchiluvari/project-jarvis/blob/main/services/core-backend/agent.py): `services/core-backend/agent.py`

### State infrastructure

- **Redis**

### Other components

- **Chat client**

## Connections

- Chat client → Frontend app: uses
- Frontend app → Chat stream API: submits chat
- Chat stream API → Agent: runs agent (evidence: `services/core-backend/main.py`)
- Chat stream API → Redis: checks connection (evidence: `services/core-backend/main.py`)
