Projects

Quorum — Deep-Research Agent Swarm with a Shared GraphRAG Brain

Active
Python 3.12FastAPIServer-Sent EventsNetworkXfastembedReactVitereact-force-graph-2dzustandframer-motionAnthropic APIOllama (qwen3:14b)
Product demo

Problem

Most AI research tools are one model in a loop. It cannot hold a multi-hop question together, it has no second opinion, and vanilla vector RAG fumbles exactly the questions that need relationships rather than similar-looking paragraphs.

Business Impact

Research questions that matter are multi-hop, and a single-model loop answers them confidently and wrongly. A swarm with an explicit Critic and a shared graph makes the reasoning inspectable — you can see which entity connected to which, and which agent found it.

System Approach

  • Orchestrator emits events; Planner, N Researchers, Critic, and Synthesizer run against a shared graph
  • GraphRAG store on NetworkX plus embeddings, with merge-on-write entity normalization
  • Graph-aware retrieval: top-k nodes, neighbour expansion, subgraph to the Synthesizer
  • FastAPI backend streams every agent action over SSE
  • React and Vite frontend renders the live force graph and the agent roster
  • Deterministic demo mode runs with zero config and no keys

Key Decisions & Trade-offs

  • Shared graph over message passing — the graph is the coordination substrate, not a side effect
  • Merge-on-write so duplicate discoveries converge instead of forking the answer
  • An explicit Critic agent, because a swarm without one just agrees with itself faster
  • Stream everything as events so the UI is a view of the run, not a summary of it
  • Deterministic demo mode so the project can be tried and filmed without an API key

Current Status

Public and open source at github.com/rohitguta2432/quorum. Full swarm, GraphRAG store, and live streaming UI working; runs zero-config in deterministic demo mode and against Anthropic or local Ollama for real research. Design notes in docs/DESIGN.md.

Roadmap

  • Persist graphs across sessions so research compounds
  • Source-level provenance on every edge
  • Configurable swarm shape — researcher count and critic strictness per question

What I'd Improve Next

  • Better embeddings by default rather than as an optional install
  • Export the built graph to standard formats for downstream tools

Explore More