How hardikagarwal23/multi-agent-ai-research-system works
This is a multi-agent research assistant with Streamlit and CLI entry points. Its main workflow plans queries, searches the web, pauses for human source triage, drafts and reviews a report with bounded retries, then publishes the result. The graph owns agent routing; the nodes perform research stages and use Gemini, Tavily, and structured review output. The README documents the HITL gate and major capabilities; source-level evidence is available for the graph, UI, agents, and model integrations, but not every runtime detail.
Main entry points: graph.py Research graph · nodes.py Fact reviewer · llm.py Gemini adapter · app.py Source review gate
Components 16
User interfaces
- Streamlit UI
app.py - CLI interface
main.py - Source review gate
app.py - Final report display
app.py
Workflow orchestration
- Research graph
graph.py
Research stages
- Query planner
nodes.py - Web search
nodes.py - Report drafter
nodes.py - Fact reviewer
nodes.py - Report publisher
nodes.py
State and AI services
- Research state
state.py - Review result schema
schema.py - Gemini adapter
llm.py
Other components
- Research user
- Google Gemini
- Tavily Search
Connections 26
- Research user → Streamlit UI: enters topic
README.md - Research user → CLI interface: enters topic
main.py - Streamlit UI → Research graph: builds and invokes
app.py - CLI interface → Research graph: builds and invokes
main.py - Research graph → Query planner: dispatches
graph.py - Research graph → Web search: dispatches
graph.py - Research graph → Report drafter: dispatches
graph.py - Research graph → Fact reviewer: dispatches
graph.py - Research graph → Report publisher: dispatches
graph.py - Research graph → Source review gate: pauses after search
README.md - Query planner → Web search: provides queries
README.md - Web search → Source review gate: presents sources
README.md - Source review gate → Report drafter: approves sources
app.py - Report drafter → Fact reviewer: submits draft
README.md - Fact reviewer → Report drafter: requests rewrite
graph.py - Fact reviewer → Report publisher: approves draft
graph.py - Report publisher → Final report display: produces report
app.py - Query planner → Gemini adapter: requests completions
nodes.py - Report drafter → Gemini adapter: requests completions
nodes.py - Fact reviewer → Gemini adapter: requests evaluation
nodes.py - Report publisher → Gemini adapter: requests formatting
nodes.py - Gemini adapter → Google Gemini: calls model
llm.py - Web search → Tavily Search: submits queries
nodes.py - Fact reviewer → Review result schema: validates output
nodes.py - Research graph → Research state: uses typed state
graph.py - Query planner → Research state: reads and updates
nodes.py