{"title":"Synapse आर्किटेक्चर","slug":"architecture","category":"concepts","summary":"Synapse कैसे बना है — Fastify, PostgreSQL, FTS5, embeddings, MCP server।","audience":["human","llm"],"tags":["architecture","design","components"],"difficulty":"intermediate","updated":"2026-06-27","word_count":495,"read_minutes":2,"lang":"hi","translated":true,"requested_lang":"hi","content_markdown":"\n# Synapse आर्किटेक्चर\n\nSynapse एक मल्टी-टैनेंट मेमोरी API है जो Fastify, FTS5 के साथ PostgreSQL, और सिमेंटिक खोज के लिए एक वैकल्पिक embeddings सेवा पर बना है।\n\n## उच्च-स्तरीय आर्किटेक्चर\n\n```\n┌──────────────────────────────────────────────────────────┐\n│ Clients │\n├──────────────┬──────────────┬──────────────┬─────────────┤\n│ LLM Agents │ Web Browsers│ MCP Clients │ Webhooks │\n│ (curl/SDK) │ (humans) │ (Claude/etc) │ (external) │\n└──────┬───────┴──────┬───────┴──────┬───────┴──────┬──────┘\n │ │ │ │\n └──────────────┴──────────────┴──────────────┘\n │\n ▼\n ┌───────────────────────────────┐\n │ Synapse API (Fastify) │\n │ port 12800 │\n │ - REST endpoints │\n │ - Auth (Mind Key / JWT) │\n │ - Rate limiting │\n │ - Static file serving │\n └───────────────┬───────────────┘\n │\n ┌───────────────┼───────────────┐\n ▼ ▼ ▼\n ┌─────────────┐ ┌─────────────┐ ┌─────────────┐\n │ PostgreSQL │ │ Embeddings │ │ MCP Server │\n │ + FTS5 │ │ Service │ │ (separate) │\n │ │ │ (optional) │ │ port 13100 │\n │ - memories │ │ │ │ │\n │ - tasks │ │ - generate │ │ - 79 tools │\n │ - chat │ │ embeddings│ │ - stdio/SSE │\n │ - scripts │ │ │ │ - WebSocket │\n └─────────────┘ └─────────────┘ └─────────────┘\n```\n\n## मुख्य घटक\n\n### 1. Synapse API (Fastify)\n\nमुख्य HTTP server। संभालता है:\n\n- REST एंडपॉइंट्स (`/memory`, `/chat`, `/mind/tasks`, आदि)\n- प्रमाणीकरण (एजेंट्स के लिए Mind Key, मानवों के लिए JWT)\n- रेट लिमिटिंग (केवल `?key=` प्रमाणीकरण)\n- स्टेटिक फ़ाइल सर्विंग (`/human`, `/docs`, आदि पर वेब UI)\n- Webhook डिस्पैच\n\nप्रदर्शन के लिए **Fastify 5** के साथ बना। उत्पादन में पोर्ट 12800 पर चलता है।\n\n### 2. FTS5 के साथ PostgreSQL\n\nप्राथमिक डेटा स्टोर। फुल-टेक्स्ट खोज के लिए FTS5 एक्सटेंशन के साथ PostgreSQL का उपयोग करता है।\n\n**मुख्य तालिकाएँ:**\n\n| तालिका | उद्देश्य |\n|-------|---------|\n| `users` | उपयोगकर्ता खाते |\n| `minds` | Mind दायरे (प्रत्येक के पास Mind Key है) |\n| `memories` | FTS5 वर्चुअल तालिका के साथ मेमोरी रिकॉर्ड्स |\n| `tasks` | कार्य प्रबंधन |\n| `chat_messages` | चैट इतिहास |\n| `scripts` | स्थायी स्क्रिप्ट्स |\n| `webhooks` | Webhook पंजीकरण |\n| `cron_jobs` | शेड्यूल किए गए कार्य |\n| `variables` | Key-value स्टोर |\n| `audit_log` | ऑडिट ट्रेल |\n\n**FTS5** सभी मेमोरी सामग्री में सब-मिलीसेकंड फुल-टेक्स्ट खोज सक्षम बनाता है। विवरण के लिए [FTS5 Search](/docs/concepts/fts5-search) देखें।\n\n### 3. Embeddings सेवा (वैकल्पिक)\n\nसिमेंटिक खोज के लिए, Synapse मेमोरी सामग्री के वेक्टर embeddings जनरेट करता है। ये मेमोरीज़ के साथ संग्रहीत होते हैं और समानता खोज के लिए उपयोग किए जाते हैं।\n\n- प्रदाता: कॉन्फ़िगर करने योग्य (OpenAI, लोकल मॉडल, आदि)\n- `memories` तालिका में `vector` कॉलम के रूप में संग्रहीत\n- `/memory/semantic-search` एंडपॉइंट द्वारा उपयोग\n- [सिमेंटिक खोज](/docs/concepts/semantic-search) देखें\n\n### 4. MCP Server (अलग सेवा)\n\nSynapse MCP server एक अलग प्रक्रिया के रूप में चलता है (पोर्ट 13100)। यह:\n\n- Model Context Protocol के माध्यम से 79 टूल्स एक्सपोज़ करता है\n- stdio, HTTP/SSE, और WebSocket ट्रांसपोर्ट का समर्थन करता है\n- MCP टूल कॉल्स को Synapse API कॉल्स में अनुवादित करता है\n- मल्टी-टैनेंट: प्रति सत्र एक Mind Key\n\n### 5. Browser Proxy (अलग सेवा)\n\nब्राउज़र ऑटोमेशन के लिए, एक अलग Playwright-आधारित सेवा पोर्ट 13000 पर चलती है। MCP server `browser_*` टूल्स के लिए इसे कॉल कर सकता है।\n\n### 6. SSH Proxy (अलग सेवा)\n\nSSH-आधारित रिमोट कमांड्स के लिए, एक अलग सेवा पोर्ट 12900 पर चलती है।\n\n## मल्टी-टैनेंसी मॉडल\n\n```\nUser Account (email + password)\n │\n ├── Mind 1 (Mind Key 1)\n │ ├── Memories\n │ ├── Tasks\n │ ├── Chat\n │ └── Scripts\n │\n ├── Mind 2 (Mind Key 2)\n │ └── ... (isolated from Mind 1)\n │\n └── Mind 3 (Mind Key 3)\n └── ...\n```\n\nप्रत्येक mind पूरी तरह से अलग है। Mind Keys ठीक एक mind तक पहुँच प्रदान करते हैं।\nJWTs उपयोगकर्ता खाते तक पहुँच प्रदान करते हैं (minds प्रबंधित करने के लिए)।\n\nविवरण के लिए [मल्टी-टैनेंसी](/docs/concepts/multi-tenancy) देखें।\n\n## अनुरोध प्रवाह\n\n### मेमोरी स्टोर अनुरोध\n\n```\n1. Client sends POST /memory with Authorization: Bearer mk_xxx\n2. Fastify receives request\n3. Auth middleware validates Mind Key, attaches mind_id to request\n4. Memory route handler:\n a. Validate JSON body (zod schema)\n b. Insert into memories table\n c. Update FTS5 index\n d. (Async) Generate embedding if embeddings enabled\n e. Trigger webhooks for memory.store event\n5. Return { id, status: \"stored\" }\n```\n\n### मेमोरी खोज अनुरोध\n\n```\n1. Client sends GET /memory/search?q=docker\n2. Auth middleware validates Mind Key\n3. Memory route handler:\n a. Parse query (FTS5 syntax)\n b. Execute FTS5 MATCH against memories table\n c. Filter by mind_id (tenant isolation)\n d. Rank by relevance\n e. Return results\n```\n\n## परिनियोजन\n\nSynapse एक Docker कंटेनर के रूप में परिनियोजित होता है। `docker-compose.yml` देखें:\n\n```yaml\nservices:\n synapse:\n image: registry.gitlab.com/schaefer-services/synapse:latest\n ports:\n - \"12800:12800\"\n environment:\n - DATABASE_URL=postgres://...\n - JWT_SECRET=...\n - SYNAPSE_HOST=0.0.0.0\n - SYNAPSE_PORT=12800\n depends_on:\n - postgres\n \n postgres:\n image: postgres:16\n volumes:\n - pgdata:/var/lib/postgresql/data\n environment:\n - POSTGRES_DB=synapse\n - POSTGRES_PASSWORD=...\n```\n\n## प्रदर्शन विशेषताएँ\n\n| ऑपरेशन | विलंबता | थ्रूपुट |\n|-----------|---------|------------|\n| मेमोरी स्टोर | ~5ms | 1000+ req/s |\n| मेमोरी रिकॉल | ~20ms | 500 req/s |\n| FTS5 खोज | ~10ms | 800 req/s |\n| सिमेंटिक खोज | ~50ms | 200 req/s |\n| चैट poll | ~5ms | 2000 req/s |\n\n## अगले कदम\n\n- [मेमोरी मॉडल](/docs/concepts/memory-model)\n- [मल्टी-टैनेंसी](/docs/concepts/multi-tenancy)\n- [FTS5 Search](/docs/concepts/fts5-search)\n","content_html":"

Synapse आर्किटेक्चर

\n

Synapse एक मल्टी-टैनेंट मेमोरी API है जो Fastify, FTS5 के साथ PostgreSQL, और सिमेंटिक खोज के लिए एक वैकल्पिक embeddings सेवा पर बना है।

\n

उच्च-स्तरीय आर्किटेक्चर

\n
┌──────────────────────────────────────────────────────────┐\n│                       Clients                            │\n├──────────────┬──────────────┬──────────────┬─────────────┤\n│  LLM Agents  │  Web Browsers│  MCP Clients │  Webhooks   │\n│  (curl/SDK)  │  (humans)    │ (Claude/etc) │  (external) │\n└──────┬───────┴──────┬───────┴──────┬───────┴──────┬──────┘\n       │              │              │              │\n       └──────────────┴──────────────┴──────────────┘\n                              │\n                              ▼\n              ┌───────────────────────────────┐\n              │    Synapse API (Fastify)      │\n              │    port 12800                 │\n              │    - REST endpoints           │\n              │    - Auth (Mind Key / JWT)    │\n              │    - Rate limiting            │\n              │    - Static file serving      │\n              └───────────────┬───────────────┘\n                              │\n              ┌───────────────┼───────────────┐\n              ▼               ▼               ▼\n       ┌─────────────┐ ┌─────────────┐ ┌─────────────┐\n       │ PostgreSQL  │ │ Embeddings  │ │ MCP Server  │\n       │ + FTS5      │ │ Service     │ │ (separate)  │\n       │             │ │ (optional)  │ │ port 13100  │\n       │ - memories  │ │             │ │             │\n       │ - tasks     │ │ - generate  │ │ - 79 tools  │\n       │ - chat      │ │   embeddings│ │ - stdio/SSE │\n       │ - scripts   │ │             │ │ - WebSocket │\n       └─────────────┘ └─────────────┘ └─────────────┘

मुख्य घटक

\n

1. Synapse API (Fastify)

\n

मुख्य HTTP server। संभालता है:

\n\n

प्रदर्शन के लिए Fastify 5 के साथ बना। उत्पादन में पोर्ट 12800 पर चलता है।

\n

2. FTS5 के साथ PostgreSQL

\n

प्राथमिक डेटा स्टोर। फुल-टेक्स्ट खोज के लिए FTS5 एक्सटेंशन के साथ PostgreSQL का उपयोग करता है।

\n

मुख्य तालिकाएँ:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
तालिकाउद्देश्य
usersउपयोगकर्ता खाते
mindsMind दायरे (प्रत्येक के पास Mind Key है)
memoriesFTS5 वर्चुअल तालिका के साथ मेमोरी रिकॉर्ड्स
tasksकार्य प्रबंधन
chat_messagesचैट इतिहास
scriptsस्थायी स्क्रिप्ट्स
webhooksWebhook पंजीकरण
cron_jobsशेड्यूल किए गए कार्य
variablesKey-value स्टोर
audit_logऑडिट ट्रेल
\n

FTS5 सभी मेमोरी सामग्री में सब-मिलीसेकंड फुल-टेक्स्ट खोज सक्षम बनाता है। विवरण के लिए FTS5 Search देखें।

\n

3. Embeddings सेवा (वैकल्पिक)

\n

सिमेंटिक खोज के लिए, Synapse मेमोरी सामग्री के वेक्टर embeddings जनरेट करता है। ये मेमोरीज़ के साथ संग्रहीत होते हैं और समानता खोज के लिए उपयोग किए जाते हैं।

\n\n

4. MCP Server (अलग सेवा)

\n

Synapse MCP server एक अलग प्रक्रिया के रूप में चलता है (पोर्ट 13100)। यह:

\n\n

5. Browser Proxy (अलग सेवा)

\n

ब्राउज़र ऑटोमेशन के लिए, एक अलग Playwright-आधारित सेवा पोर्ट 13000 पर चलती है। MCP server browser_* टूल्स के लिए इसे कॉल कर सकता है।

\n

6. SSH Proxy (अलग सेवा)

\n

SSH-आधारित रिमोट कमांड्स के लिए, एक अलग सेवा पोर्ट 12900 पर चलती है।

\n

मल्टी-टैनेंसी मॉडल

\n
User Account (email + password)\n  │\n  ├── Mind 1 (Mind Key 1)\n  │   ├── Memories\n  │   ├── Tasks\n  │   ├── Chat\n  │   └── Scripts\n  │\n  ├── Mind 2 (Mind Key 2)\n  │   └── ... (isolated from Mind 1)\n  │\n  └── Mind 3 (Mind Key 3)\n      └── ...

प्रत्येक mind पूरी तरह से अलग है। Mind Keys ठीक एक mind तक पहुँच प्रदान करते हैं।\nJWTs उपयोगकर्ता खाते तक पहुँच प्रदान करते हैं (minds प्रबंधित करने के लिए)।

\n

विवरण के लिए मल्टी-टैनेंसी देखें।

\n

अनुरोध प्रवाह

\n

मेमोरी स्टोर अनुरोध

\n
1. Client sends POST /memory with Authorization: Bearer mk_xxx\n2. Fastify receives request\n3. Auth middleware validates Mind Key, attaches mind_id to request\n4. Memory route handler:\n   a. Validate JSON body (zod schema)\n   b. Insert into memories table\n   c. Update FTS5 index\n   d. (Async) Generate embedding if embeddings enabled\n   e. Trigger webhooks for memory.store event\n5. Return { id, status: "stored" }

मेमोरी खोज अनुरोध

\n
1. Client sends GET /memory/search?q=docker\n2. Auth middleware validates Mind Key\n3. Memory route handler:\n   a. Parse query (FTS5 syntax)\n   b. Execute FTS5 MATCH against memories table\n   c. Filter by mind_id (tenant isolation)\n   d. Rank by relevance\n   e. Return results

परिनियोजन

\n

Synapse एक Docker कंटेनर के रूप में परिनियोजित होता है। docker-compose.yml देखें:

\n
services:\n  synapse:\n    image: registry.gitlab.com/schaefer-services/synapse:latest\n    ports:\n      - "12800:12800"\n    environment:\n      - DATABASE_URL=postgres://...\n      - JWT_SECRET=...\n      - SYNAPSE_HOST=0.0.0.0\n      - SYNAPSE_PORT=12800\n    depends_on:\n      - postgres\n  \n  postgres:\n    image: postgres:16\n    volumes:\n      - pgdata:/var/lib/postgresql/data\n    environment:\n      - POSTGRES_DB=synapse\n      - POSTGRES_PASSWORD=...

प्रदर्शन विशेषताएँ

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ऑपरेशनविलंबताथ्रूपुट
मेमोरी स्टोर~5ms1000+ req/s
मेमोरी रिकॉल~20ms500 req/s
FTS5 खोज~10ms800 req/s
सिमेंटिक खोज~50ms200 req/s
चैट poll~5ms2000 req/s
\n

अगले कदम

\n\n","urls":{"html":"/docs/concepts/architecture","text":"/docs/concepts/architecture?format=text","json":"/docs/concepts/architecture?format=json","llm":"/docs/concepts/architecture?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}