# priyamkakadiya153/mindmesh architecture

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

- Interactive diagram: https://gitdiagram.com/priyamkakadiya153/mindmesh
- Repository: https://github.com/priyamkakadiya153/mindmesh

## Overview

MindMesh is a knowledge-intelligence platform: users communicate and share files, then retrieve or act on the knowledge those interactions contain. The principal flow is file ingestion into normalized, chunked content, followed by permission-aware semantic retrieval and grounded answers with citations; users can also search across knowledge and turn conversational intent into actions. The README documents messaging, file preview, summaries, task and decision extraction, notifications, and dashboards. Some capabilities are represented by their exact tree paths but were not sampled, so their internal links are intentionally omitted.

Main entry points: [`apps/web/src/App.tsx`](https://github.com/priyamkakadiya153/mindmesh/blob/main/apps/web/src/App.tsx) (Web application), [`apps/api/app/database`](https://github.com/priyamkakadiya153/mindmesh/tree/main/apps/api/app/database) (Relational data), [`apps/api/app/processing/pipeline.py`](https://github.com/priyamkakadiya153/mindmesh/blob/main/apps/api/app/processing/pipeline.py) (Content processing), [`apps/api/app/ai/rag/pipeline.py`](https://github.com/priyamkakadiya153/mindmesh/blob/main/apps/api/app/ai/rag/pipeline.py) (Grounded answers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_web["Web application<br/>[App.tsx]"]
  node_auth["Authentication"]
  node_dashboard["Dashboard"]
end

subgraph group_capture["Communication and files"]
  node_messaging["Messaging"]
  node_documents["File management<br/>[service.py]"]
end

subgraph group_knowledge["Knowledge processing"]
  node_ingestion["Content processing<br/>[pipeline.py]"]
  node_embeddings["Embeddings"]
  node_memory["Organizational memory"]
  node_database[("Relational data")]
end

subgraph group_intelligence["Search and answers"]
  node_searchui["Search client<br/>[searchService.ts]"]
  node_search["Hybrid search<br/>[hybrid_engine.py]"]
  node_rag["Grounded answers<br/>[pipeline.py]"]
  node_intent["Request understanding<br/>[engine.py]"]
  node_cognitive["Cognitive agents"]
end

subgraph group_action["Actions and operations"]
  node_actions["Action execution"]
  node_automation["Workflow automation<br/>[engine.py]"]
  node_proactive["Proactive detection"]
  node_analytics["Analytics"]
end

node_user(("User"))

node_user -.->|"uses"| node_web
node_web -.->|"offers search"| node_searchui
node_searchui -->|"requests results"| node_search
node_web -.->|"authenticates"| node_auth
node_web -.->|"communicates"| node_messaging
node_web -.->|"manages files"| node_documents
node_documents -.->|"processes content"| node_ingestion
node_ingestion -->|"stores chunks"| node_database
node_ingestion -->|"uses embeddings"| node_embeddings
node_search -->|"queries index"| node_database
node_rag -->|"retrieves context"| node_database
node_rag -->|"retrieves knowledge"| node_search
node_web -.->|"asks questions"| node_rag
node_intent -->|"classifies actions"| node_actions
node_cognitive -->|"reads knowledge"| node_database
node_cognitive -->|"loads memories"| node_memory
node_actions -.->|"runs workflows"| node_automation
node_web -.->|"views dashboard"| node_dashboard
node_web -.->|"views insights"| node_analytics
node_messaging -.->|"detects actions"| node_proactive

click node_web "https://github.com/priyamkakadiya153/mindmesh/blob/main/apps/web/src/App.tsx"
click node_auth "https://github.com/priyamkakadiya153/mindmesh/tree/main/apps/api/app/auth"
click node_dashboard "https://github.com/priyamkakadiya153/mindmesh/tree/main/apps/api/app/dashboard"
click node_messaging "https://github.com/priyamkakadiya153/mindmesh/tree/main/apps/api/app/conversations"
click node_documents "https://github.com/priyamkakadiya153/mindmesh/blob/main/apps/api/app/documents/service.py"
click node_ingestion "https://github.com/priyamkakadiya153/mindmesh/blob/main/apps/api/app/processing/pipeline.py"
click node_embeddings "https://github.com/priyamkakadiya153/mindmesh/tree/main/apps/api/app/ai/embeddings"
click node_memory "https://github.com/priyamkakadiya153/mindmesh/blob/main/apps/api/app/orchestration/memory_orchestrator_service.py"
click node_searchui "https://github.com/priyamkakadiya153/mindmesh/blob/main/apps/web/src/features/search/searchService.ts"
click node_search "https://github.com/priyamkakadiya153/mindmesh/blob/main/apps/api/app/search/hybrid_engine.py"
click node_rag "https://github.com/priyamkakadiya153/mindmesh/blob/main/apps/api/app/ai/rag/pipeline.py"
click node_intent "https://github.com/priyamkakadiya153/mindmesh/blob/main/apps/api/app/ai/understanding/engine.py"
click node_cognitive "https://github.com/priyamkakadiya153/mindmesh/blob/main/apps/api/app/agents/cognitive_engine.py"
click node_actions "https://github.com/priyamkakadiya153/mindmesh/tree/main/apps/api/app/actions"
click node_automation "https://github.com/priyamkakadiya153/mindmesh/blob/main/apps/api/app/automation/workflow/engine.py"
click node_proactive "https://github.com/priyamkakadiya153/mindmesh/blob/main/apps/api/app/proactive/detection_engine.py"
click node_analytics "https://github.com/priyamkakadiya153/mindmesh/tree/main/apps/api/app/analytics"
click node_database "https://github.com/priyamkakadiya153/mindmesh/tree/main/apps/api/app/database"

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_web,node_auth,node_dashboard,node_user toneBlue
class node_messaging,node_documents toneAmber
class node_ingestion,node_embeddings,node_memory,node_database toneMint
class node_searchui,node_search,node_rag,node_intent,node_cognitive toneRose
class node_actions,node_automation,node_proactive,node_analytics toneIndigo
```

## Components

### User experience

- [Web application](https://github.com/priyamkakadiya153/mindmesh/blob/main/apps/web/src/App.tsx): `apps/web/src/App.tsx`
- [Authentication](https://github.com/priyamkakadiya153/mindmesh/tree/main/apps/api/app/auth): `apps/api/app/auth`
- [Dashboard](https://github.com/priyamkakadiya153/mindmesh/tree/main/apps/api/app/dashboard): `apps/api/app/dashboard`

### Communication and files

- [Messaging](https://github.com/priyamkakadiya153/mindmesh/tree/main/apps/api/app/conversations): `apps/api/app/conversations`
- [File management](https://github.com/priyamkakadiya153/mindmesh/blob/main/apps/api/app/documents/service.py): `apps/api/app/documents/service.py`

### Knowledge processing

- [Content processing](https://github.com/priyamkakadiya153/mindmesh/blob/main/apps/api/app/processing/pipeline.py): `apps/api/app/processing/pipeline.py`
- [Embeddings](https://github.com/priyamkakadiya153/mindmesh/tree/main/apps/api/app/ai/embeddings): `apps/api/app/ai/embeddings`
- [Organizational memory](https://github.com/priyamkakadiya153/mindmesh/blob/main/apps/api/app/orchestration/memory_orchestrator_service.py): `apps/api/app/orchestration/memory_orchestrator_service.py`
- [Relational data](https://github.com/priyamkakadiya153/mindmesh/tree/main/apps/api/app/database): `apps/api/app/database`

### Search and answers

- [Search client](https://github.com/priyamkakadiya153/mindmesh/blob/main/apps/web/src/features/search/searchService.ts): `apps/web/src/features/search/searchService.ts`
- [Hybrid search](https://github.com/priyamkakadiya153/mindmesh/blob/main/apps/api/app/search/hybrid_engine.py): `apps/api/app/search/hybrid_engine.py`
- [Grounded answers](https://github.com/priyamkakadiya153/mindmesh/blob/main/apps/api/app/ai/rag/pipeline.py): `apps/api/app/ai/rag/pipeline.py`
- [Request understanding](https://github.com/priyamkakadiya153/mindmesh/blob/main/apps/api/app/ai/understanding/engine.py): `apps/api/app/ai/understanding/engine.py`
- [Cognitive agents](https://github.com/priyamkakadiya153/mindmesh/blob/main/apps/api/app/agents/cognitive_engine.py): `apps/api/app/agents/cognitive_engine.py`

### Actions and operations

- [Action execution](https://github.com/priyamkakadiya153/mindmesh/tree/main/apps/api/app/actions): `apps/api/app/actions`
- [Workflow automation](https://github.com/priyamkakadiya153/mindmesh/blob/main/apps/api/app/automation/workflow/engine.py): `apps/api/app/automation/workflow/engine.py`
- [Proactive detection](https://github.com/priyamkakadiya153/mindmesh/blob/main/apps/api/app/proactive/detection_engine.py): `apps/api/app/proactive/detection_engine.py`
- [Analytics](https://github.com/priyamkakadiya153/mindmesh/tree/main/apps/api/app/analytics): `apps/api/app/analytics`

### Other components

- **User**

## Connections

- User → Web application: uses
- Web application → Search client: offers search
- Search client → Hybrid search: requests results (evidence: `apps/web/src/features/search/searchService.ts`)
- Web application → Authentication: authenticates
- Web application → Messaging: communicates
- Web application → File management: manages files
- File management → Content processing: processes content
- Content processing → Relational data: stores chunks (evidence: `apps/api/app/processing/pipeline.py`)
- Content processing → Embeddings: uses embeddings (evidence: `apps/api/app/processing/pipeline.py`)
- Hybrid search → Relational data: queries index (evidence: `apps/api/app/search/hybrid_engine.py`)
- Grounded answers → Relational data: retrieves context (evidence: `apps/api/app/ai/rag/pipeline.py`)
- Grounded answers → Hybrid search: retrieves knowledge
- Web application → Grounded answers: asks questions
- Request understanding → Action execution: classifies actions (evidence: `apps/api/app/ai/understanding/engine.py`)
- Cognitive agents → Relational data: reads knowledge (evidence: `apps/api/app/agents/cognitive_engine.py`)
- Cognitive agents → Organizational memory: loads memories (evidence: `apps/api/app/agents/cognitive_engine.py`)
- Action execution → Workflow automation: runs workflows
- Web application → Dashboard: views dashboard
- Web application → Analytics: views insights
- Messaging → Proactive detection: detects actions
