How mohiitt/quorum works
Quorum is a trust and consensus gate for Fetch.ai multi-agent workflows. A claim enters through the API or an agent, is checked by source, consistency, and reasoning validators, then scored into a verdict; accepted claims update workflow state, while review-needed claims are quarantined. The pipeline also records provenance and updates agent and validator trust. The API exposes these results to a dashboard and a WebSocket event stream. The README documents the product flow; unsampled dashboard and agent internals are represented at their exact tree paths, with uncertain wiring omitted.
Main entry points: pipeline.py Validation Pipeline · api.ts Dashboard API Client · redis_store.py Redis Store · routes.py REST Routes
Components 25
Claim Entry
- Validation Pipeline
quorum/pipeline.py - Shared Claim Models
quorum/contracts/models.py
Validation And Consensus
- Source Validator
quorum/validators/source.py - Consistency Validator
quorum/validators/consistency.py - Reasoning Validator
quorum/validators/reasoning.py - Consensus Engine
quorum/consensus/engine.py - Consensus Scoring
quorum/consensus/scoring.py
Workflow State
- Claim Quarantine
quorum/consensus/quarantine.py - Redis Store
quorum/state/redis_store.py - Canonical Workflow State
quorum/state/redis_store.py - Provenance Records
quorum/state/provenance.py - Trust Scores
quorum/state/trust.py
API And Dashboard
- FastAPI Service
quorum/api/main.py - REST Routes
quorum/api/routes.py - WebSocket Stream
quorum/api/ws.py - Consensus Event Bus
quorum/api/event_bus.py - Dashboard API Client
dashboard/src/lib/api.ts - Live Consensus View
dashboard/src/app/consensus/page.tsx - Provenance View
dashboard/src/app/provenance/page.tsx - Trust View
dashboard/src/app/trust/page.tsx - Quarantine View
dashboard/src/app/quarantine/page.tsx
Agent Integrations
- uAgent Gateway
quorum/agents/agentverse_agent.py - Agent Protocols
quorum/agents/protocols.py - Weather Demo Workflow
quorum/agents/demo_workflow.py
Other components
- Workflow Agent
Connections 30
- Workflow Agent → FastAPI Service: submits claim
README.md - FastAPI Service → REST Routes: mounts routes
quorum/api/main.py - REST Routes → Validation Pipeline: validates claim
quorum/api/routes.py - Validation Pipeline → Source Validator: runs validator
quorum/pipeline.py - Validation Pipeline → Consistency Validator: runs validator
quorum/pipeline.py - Validation Pipeline → Reasoning Validator: runs validator
quorum/pipeline.py - Validation Pipeline → Consensus Engine: scores results
quorum/pipeline.py - Consensus Engine → Consensus Scoring: computes score
quorum/consensus/engine.py - Validation Pipeline → Claim Quarantine: routes review claims
README.md - Validation Pipeline → Canonical Workflow State: writes accepted claims
README.md - Validation Pipeline → Provenance Records: records outcome
quorum/pipeline.py - Validation Pipeline → Trust Scores: updates scores
quorum/pipeline.py - Validation Pipeline → Redis Store: persists data
quorum/pipeline.py - Canonical Workflow State → Redis Store: stored in
quorum/state/redis_store.py - Provenance Records → Redis Store: stored in
quorum/state/provenance.py - Trust Scores → Redis Store: stored in
quorum/state/trust.py - Validation Pipeline → Consensus Event Bus: publishes events
quorum/pipeline.py - FastAPI Service → WebSocket Stream: routes stream
quorum/api/main.py - WebSocket Stream → Consensus Event Bus: subscribes events
quorum/api/ws.py - REST Routes → Redis Store: reads claim data
quorum/api/routes.py - Dashboard API Client → FastAPI Service: requests results
- Live Consensus View → Dashboard API Client: uses client
- Provenance View → Dashboard API Client: uses client
- Trust View → Dashboard API Client: uses client
- Quarantine View → Dashboard API Client: uses client
- uAgent Gateway → Validation Pipeline: submits claims
quorum/agents/agentverse_agent.py - uAgent Gateway → Agent Protocols: uses protocols
quorum/agents/agentverse_agent.py - Weather Demo Workflow → uAgent Gateway: demonstrates gate
README.md - REST Routes → Shared Claim Models: builds claim
quorum/api/routes.py - Validation Pipeline → Shared Claim Models: processes claims
quorum/pipeline.py