How ayushgupta-h/ai_reasearch works
Research AI is a multi-agent research product, exposed through a web client and backend services as well as a Python/CLI workflow. Its documented research run moves from query planning through evidence retrieval and analysis to report writing, peer review, revision, and export. The backend also exposes session, document, review, and report capabilities, with persistence and execution infrastructure supporting runs. Workflow stages follow the README’s architecture; some implementation details and API wiring are unsampled, so those links are omitted.
Main entry points: research_service.py Research Service · orchestrator.py Peer Review · research_tasks.py Task Worker · research_executor.py Research Executor
Components 22
Client
- Research UI
frontend/src/pages/index.tsx - API Client
frontend/src/api/client.ts
Backend Services
- Backend API
backend/app/api - Research Service
backend/app/services/research_service.py - Report Services
backend/app/services - Review Service
backend/app/services/review_service.py
Research Workflow
- Query Intake
backend/query_intake.py - Source Search
backend/search_sources.py - Deep Reader
backend/agent.py - Fact Analysis
backend/orchestrator.py - Report Writing
backend/orchestrator.py - Peer Review
backend/orchestrator.py - Revision
backend/orchestrator.py - Report Export
backend/report_exporter.py - Research Pipeline
backend/app/orchestration/pipeline.py
Runtime Support
- Research Executor
backend/app/infrastructure/research_executor.py - Task Worker
backend/research_tasks.py - Run Events
backend/app/events/service.py
Persistence
- Session Manager
backend/session_manager.py - Application Database
backend/app/database/session.py - Document Storage
backend/app/services/storage_service.py
Other components
- Researcher
Connections 21
- Researcher → Research UI: submits research
README.md - Research UI → API Client: requests data
frontend/src/pages/index.tsx - API Client → Backend API: calls API
- Backend API → Research Service: handles research
- Research Service → Research Executor: executes run
backend/app/services/research_service.py - Research Executor → Research Pipeline: builds orchestrator
backend/app/infrastructure/research_executor.py - Research Pipeline → Query Intake: starts workflow
backend/app/orchestration/pipeline.py - Query Intake → Source Search: plans then searches
README.md - Source Search → Deep Reader: finds pages for
README.md - Deep Reader → Fact Analysis: supplies evidence
README.md - Fact Analysis → Report Writing: synthesizes for
README.md - Report Writing → Peer Review: submits report
README.md - Peer Review → Revision: requests revision
README.md - Revision → Peer Review: returns revision
README.md - Peer Review → Report Export: approves report
README.md - Research Service → Task Worker: dispatches work
- Task Worker → Research Executor: runs research
backend/research_tasks.py - Task Worker → Run Events: publishes outcomes
backend/research_tasks.py - Research Service → Session Manager: manages sessions
backend/app/services/research_service.py - Report Services → Document Storage: stores reports
backend/app/services/storage_service.py - Review Service → Application Database: reads review data