How prabhat-190/synapse-flow- works
SynapseFlow accepts queries through a secured FastAPI gateway, executes a stateful multi-agent DAG on a shared blackboard, and returns a trace and answer. The pipeline owns agent dispatch, compression on budget overflow, persistence, and resume behavior. Supporting branches cover two-hop retrieval, model reliability, streaming and distributed execution, human-approved prompt rewrites, and evaluation. Edges reflect shown calls, source-index references, or README claims; some capabilities are documented but their implementation details were not sampled.
Main entry points: pipeline.py DAG Pipeline · app.py FastAPI Gateway · harness.py Evaluation Harness · base.py Agent Runtime
Components 26
API and Access
- FastAPI Gateway
src/synapse/gateway/app.py - Request Security
src/synapse/gateway/security.py
Agent Execution
- DAG Pipeline
src/synapse/agents/pipeline.py - Shared Blackboard
src/synapse/core/blackboard.py - Execution Models
src/synapse/core/models.py - Orchestrator Agent
src/synapse/agents/orchestrator.py - Decomposition Agent
src/synapse/agents/decomposition.py - Reasoning Agent
src/synapse/agents/reasoning.py - Critique Agent
src/synapse/agents/critique.py - Synthesis Agent
src/synapse/agents/synthesis.py - Compression Agent
src/synapse/agents/compression.py - Meta Agent
src/synapse/agents/meta.py - Agent Runtime
src/synapse/agents/base.py
Retrieval and Models
- Retrieval Agent
src/synapse/agents/retrieval.py - Two-Hop RAG
src/synapse/rag/two_hop.py - Embeddings
src/synapse/rag/embeddings.py - LLM Router
src/synapse/infra/llm.py - Gemini Provider
src/synapse/infra/llm.py
Persistence and Operations
- PostgreSQL Store
src/synapse/infra/database.py - Redis Event Bus
src/synapse/infra/redis_bus.py - Celery Workers
src/synapse/infra/celery_app.py - Prometheus Metrics
src/synapse/observability/metrics.py
Evaluation
- Evaluation Harness
src/synapse/eval/harness.py - Evaluation Cases
src/synapse/eval/datasets.py
Other components
- API Client
- Gemini API
Connections 33
- API Client → FastAPI Gateway: submits query
README.md - FastAPI Gateway → Request Security: screens requests
src/synapse/gateway/app.py - FastAPI Gateway → DAG Pipeline: runs query
src/synapse/gateway/app.py - FastAPI Gateway → Celery Workers: queues async run
src/synapse/gateway/app.py - FastAPI Gateway → PostgreSQL Store: loads traces
src/synapse/gateway/app.py - FastAPI Gateway → Redis Event Bus: streams events
src/synapse/gateway/app.py - FastAPI Gateway → Prometheus Metrics: exposes metrics
src/synapse/gateway/app.py - FastAPI Gateway → Meta Agent: approves rewrites
src/synapse/gateway/app.py - FastAPI Gateway → Evaluation Harness: starts evaluation
src/synapse/gateway/app.py - DAG Pipeline → Orchestrator Agent: dispatches agents
src/synapse/agents/pipeline.py - DAG Pipeline → Decomposition Agent: dispatches agents
src/synapse/agents/pipeline.py - DAG Pipeline → Retrieval Agent: dispatches agents
src/synapse/agents/pipeline.py - DAG Pipeline → Reasoning Agent: dispatches agents
src/synapse/agents/pipeline.py - DAG Pipeline → Critique Agent: dispatches agents
src/synapse/agents/pipeline.py - DAG Pipeline → Synthesis Agent: dispatches agents
src/synapse/agents/pipeline.py - DAG Pipeline → Meta Agent: dispatches agents
src/synapse/agents/pipeline.py - DAG Pipeline → Compression Agent: handles overflow
src/synapse/agents/pipeline.py - DAG Pipeline → Shared Blackboard: shares state
src/synapse/agents/pipeline.py - DAG Pipeline → PostgreSQL Store: persists traces
src/synapse/agents/pipeline.py - DAG Pipeline → Redis Event Bus: loads checkpoints
src/synapse/agents/pipeline.py - Agent Runtime → Shared Blackboard: records events
src/synapse/agents/base.py - Agent Runtime → LLM Router: requests generation
src/synapse/agents/base.py - Agent Runtime → Redis Event Bus: publishes events
src/synapse/agents/base.py - Retrieval Agent → Two-Hop RAG: retrieves context
src/synapse/agents/retrieval.py - Retrieval Agent → Embeddings: embeds queries
src/synapse/agents/retrieval.py - Two-Hop RAG → Embeddings: uses vectors
src/synapse/rag/two_hop.py - Two-Hop RAG → PostgreSQL Store: searches documents
README.md - LLM Router → Gemini Provider: routes generation
src/synapse/infra/llm.py - Gemini Provider → Gemini API: calls Gemini · Inferred; not shown in the code that was read.
- Celery Workers → DAG Pipeline: runs tasks
src/synapse/infra/celery_app.py - Evaluation Harness → Evaluation Cases: loads cases
src/synapse/eval/harness.py - Evaluation Harness → DAG Pipeline: evaluates runs
src/synapse/eval/harness.py - Evaluation Harness → LLM Router: judges results
src/synapse/eval/harness.py