How daimx1214/evidence-first-research-agent works
Evidence-First Research Agent turns a question into a cited research brief: it plans searches, gathers and ranks sources, optionally extracts fuller text, refines once when evidence is sparse, then synthesizes and verifies claims. Runs with insufficient evidence stop without synthesis. Results include confidence, citations, and a trace, with optional HTML/Markdown reports. The README documents the full workflow; the sampled agent excerpt confirms key service calls and verification behavior. Internal pipeline links rely on README documentation where their implementation was not excerpted.
Main entry points: agent.py Research runner · report.py Report generator
Components 18
Research workflow
- Research runner
src/agent.py - Query planning
src/agent.py - Query refinement
src/agent.py - Evidence threshold
src/agent.py - Nebius Token Factory
Evidence gathering
- Web search
src/agent.py - Tavily
- Evidence selection
src/agent.py - Credibility scoring
src/agent.py - Page extraction
src/agent.py
Synthesis and verification
- Cited synthesis
src/agent.py - Claim verification
src/agent.py - Citation check
src/agent.py - Confidence score
src/agent.py
Results and reports
- Answer and trace
src/agent.py - Report generator
src/report.py - HTML / Markdown
Other components
- Researcher
Connections 22
- Researcher → Research runner: asks question
README.md - Research runner → Query planning: plans queries
README.md - Query planning → Nebius Token Factory: requests inference
README.md - Research runner → Web search: searches queries
src/agent.py - Web search → Tavily: requests results
src/agent.py - Research runner → Evidence selection: selects results
README.md - Evidence selection → Credibility scoring: scores publishers
README.md - Research runner → Page extraction: extracts thin sources
README.md - Page extraction → Tavily: requests page text
README.md - Research runner → Evidence threshold: checks source count
README.md - Evidence threshold → Query refinement: refines once
README.md - Query refinement → Nebius Token Factory: requests inference
README.md - Research runner → Cited synthesis: synthesizes evidence
README.md - Cited synthesis → Nebius Token Factory: requests inference
README.md - Research runner → Claim verification: checks claims
src/agent.py - Claim verification → Nebius Token Factory: requests inference
README.md - Research runner → Citation check: checks citations
README.md - Research runner → Confidence score: scores confidence
README.md - Research runner → Answer and trace: assembles result
src/agent.py - Research runner → Report generator: renders report
src/agent.py - Report generator → HTML / Markdown: produces reports
README.md - Research runner → Answer and trace: refuses if insufficient
README.md