# nabhpatodi10/research-ai architecture

> Architecture diagram of the GitHub repository nabhpatodi10/research-ai, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-11). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nabhpatodi10/research-ai
- Repository: https://github.com/nabhpatodi10/research-ai

## Overview

##### Project type and purpose
- This is a full-stack AI research platform (“Research AI”) combining a React/Tailwind/Firebase frontend with a FastAPI backend that orchestrates LangChain/LangGraph agents and chains against multiple LLM providers.
- Users sign up/login via Firebase, submit research questions, and get AI-powered analyses.

##### File structure
- Top-level directories:
- backend/ – FastAPI application, chain/agent modules, graph builder, scrapers, DB layer, Dockerfile.
- frontend/ – React/Vite application, Tailwind styles, Firebase auth/storage, components by feature (Auth, Chat, Feedback, etc.).
- Config files: .env.example in both; backend/requirements.txt; frontend/package.json, vite.config.js, vercel.json.
- Images subfolders hold architecture and UI mockups.

##### README
- Confirms architecture: FastAPI + LangChain/LangGraph on backend, React + Firebase on frontend.
- Mentions support for multiple LLMs (OpenAI, Groq, Gemini) and a “Research Graph Architecture.”

##### Detail without overcomplicating
- Every module you see: custom_search, scrape, graph, chains, agents, database.
- How they interconnect in the orchestration layer.
- Feedback loop: user feedback flows back into the backend for model improvement or logging.

## Diagram (Mermaid)

```mermaid
flowchart TD
  subgraph "Client Side"
    direction TB
    React["React/Vite App"]:::frontend
    FirebaseAuth["Firebase Auth"]:::db
    Firestore["Firestore (DB)"]:::db
    subgraph "Frontend Build & Config"
      direction TB
      FPKG["package.json"]:::config
      Vite["vite.config.js"]:::config
      FEnv[".env.example"]:::config
      Vercel["vercel.json"]:::config
    end
  end

  subgraph "Server Side"
    direction TB
    FastAPI["FastAPI /main.py"]:::backend
    subgraph "AI Orchestration Layer"
      direction TB
      Chains["chains.py"]:::backend
      Graph["graph.py"]:::backend
      Nodes["nodes.py"]:::backend
      ChatAgent["chatagent.py"]:::backend
      ExpertAgent["expertagent.py"]:::backend
      Structures["structures.py"]:::backend
    end
    subgraph "Data Ingestion"
      direction TB
      Scrape["scrape.py"]:::backend
      CustomSearch["custom_search.py"]:::backend
    end
    DB["database.py"]:::db
    subgraph "Backend Build & Config"
      direction TB
      BReq["requirements.txt"]:::config
      BEnv[".env.example"]:::config
      Docker["Dockerfile"]:::config
    end
  end

  subgraph "External Services"
    direction TB
    OpenAI["OpenAI API"]:::external
    Groq["Groq API"]:::external
    Gemini["Gemini API"]:::external
  end

  React -->|Sign up/Login| FirebaseAuth
  React -->|Fetch/Save Chat| Firestore
  React -->|Submit Question| FastAPI
  FastAPI -->|Store/Retrieve| DB
  FastAPI -->|Ingest Docs| Scrape
  FastAPI -->|Ingest Docs| CustomSearch
  FastAPI -->|Trigger Orchestration| Chains
  Chains -->|Uses| Graph
  Chains -->|Uses| Nodes
  Chains -->|Uses| ChatAgent
  Chains -->|Uses| ExpertAgent
  Chains -->|Uses| Structures
  Chains -->|Calls| OpenAI
  Chains -->|Calls| Groq
  Chains -->|Calls| Gemini
  FastAPI -->|Return AI Response| React
  React -->|Submit Feedback| FastAPI

  click React "https://github.com/nabhpatodi10/research-ai/tree/main/frontend/src/"
  click React "https://github.com/nabhpatodi10/research-ai/blob/main/frontend/src/App.jsx"
  click React "https://github.com/nabhpatodi10/research-ai/blob/main/frontend/src/main.jsx"
  click FirebaseAuth "https://github.com/nabhpatodi10/research-ai/blob/main/frontend/src/firebase.js"
  click FirebaseAuth "https://github.com/nabhpatodi10/research-ai/blob/main/frontend/src/context/AuthContext.jsx"
  click FPKG "https://github.com/nabhpatodi10/research-ai/blob/main/frontend/package.json"
  click Vite "https://github.com/nabhpatodi10/research-ai/blob/main/frontend/vite.config.js"
  click FEnv "https://github.com/nabhpatodi10/research-ai/blob/main/frontend/.env.example"
  click Vercel "https://github.com/nabhpatodi10/research-ai/blob/main/frontend/vercel.json"
  click FastAPI "https://github.com/nabhpatodi10/research-ai/blob/main/backend/main.py"
  click Chains "https://github.com/nabhpatodi10/research-ai/blob/main/backend/chains.py"
  click Graph "https://github.com/nabhpatodi10/research-ai/blob/main/backend/graph.py"
  click Nodes "https://github.com/nabhpatodi10/research-ai/blob/main/backend/nodes.py"
  click ChatAgent "https://github.com/nabhpatodi10/research-ai/blob/main/backend/chatagent.py"
  click ExpertAgent "https://github.com/nabhpatodi10/research-ai/blob/main/backend/expertagent.py"
  click Structures "https://github.com/nabhpatodi10/research-ai/blob/main/backend/structures.py"
  click Scrape "https://github.com/nabhpatodi10/research-ai/blob/main/backend/scrape.py"
  click CustomSearch "https://github.com/nabhpatodi10/research-ai/blob/main/backend/custom_search.py"
  click DB "https://github.com/nabhpatodi10/research-ai/blob/main/backend/database.py"
  click BReq "https://github.com/nabhpatodi10/research-ai/blob/main/backend/requirements.txt"
  click BEnv "https://github.com/nabhpatodi10/research-ai/blob/main/backend/.env.example"
  click Docker "https://github.com/nabhpatodi10/research-ai/tree/main/backend/Dockerfile"

  classDef frontend fill:#ADD8E6,stroke:#000,stroke-width:1px;
  classDef backend fill:#90EE90,stroke:#000,stroke-width:1px;
  classDef external fill:#FFD580,stroke:#000,stroke-width:1px;
  classDef db fill:#D3D3D3,stroke:#000,stroke-width:1px;
  classDef config fill:#F0E68C,stroke:#000,stroke-width:1px;
```
