How ajayguptha-tech/researchos works
ResearchOS turns a research idea into an evidence-backed plan, literature analysis, and roadmap, then supports project workspaces, paper drafting, and supervisor review. Users enter through the Next.js workspace; its API client communicates with the FastAPI routes, which expose research and collaboration capabilities backed by persistent domain data. The sampled pipeline explicitly plans, searches literature, and analyzes results. The README documents broader retrieval and methodology capabilities, but several service and route implementations were not sampled, so their internal links are left unasserted.
Main entry points: routes REST API · research_pipeline.py Research pipeline · models.py Domain models · page.tsx Project workspace
Components 23
User interface
- Workspace UI
frontend/app/workspace/page.tsx - Project workspace
frontend/app/workspace/[projectId]/page.tsx - API client
frontend/lib/api.ts
Backend API
- REST API
backend/app/api/v1/routes - Research routes
backend/app/api/v1/routes/research.py - Project routes
backend/app/api/v1/routes/projects.py - Paper routes
backend/app/api/v1/routes/papers.py - Authentication
backend/app/api/v1/routes/auth.py - Supervisor review
backend/app/api/v1/routes/supervisor.py
Research intelligence
- Research pipeline
ai/pipelines/research_pipeline.py - Research planner
ai/agents/research_planner_agent.py - Literature search
ai/agents/literature_search_agent.py - Paper analysis
ai/agents/paper_analyzer_agent.py - Research agents
ai/agents
Research workspace
- Document services
backend/app/services/document_service.py - Paper drafting
backend/app/api/v1/routes/paper_drafts.py - Roadmap service
backend/app/services/roadmap_service.py
Persistence
- Domain models
backend/app/db/models.py - Paper repository
backend/app/db/repositories/paper_repository.py - Project repository
backend/app/db/repositories/project_repository.py - Relational database
backend/app/db/session.py
Other components
- Researcher
- Literature sources
Connections 23
- Researcher → Workspace UI: uses
README.md - Researcher → Project workspace: opens project
README.md - Workspace UI → API client: requests through
frontend/app/workspace/page.tsx - Project workspace → API client: requests through
frontend/app/workspace/[projectId]/page.tsx - API client → REST API: sends REST requests
README.md - REST API → Research routes: routes research
backend/app/main.py - REST API → Project routes: routes projects
backend/app/main.py - REST API → Paper routes: routes papers
backend/app/main.py - REST API → Authentication: routes authentication
backend/app/main.py - REST API → Supervisor review: routes review
backend/app/main.py - Research pipeline → Research planner: plans idea
ai/pipelines/research_pipeline.py - Research pipeline → Literature search: searches literature
ai/pipelines/research_pipeline.py - Research pipeline → Paper analysis: analyzes results
ai/pipelines/research_pipeline.py - Literature search → Literature sources: searches
- Research routes → Research pipeline: orchestrates research
- Project routes → Roadmap service: uses roadmap logic
backend/app/api/v1/routes/projects.py - Paper routes → Document services: uses document logic
backend/app/api/v1/routes/papers.py - Project workspace → Paper drafting: requests drafts via API
frontend/app/workspace/[projectId]/page.tsx - Paper drafting → Research agents: generates drafts
backend/app/api/v1/routes/paper_drafts.py - Authentication → Domain models: creates user records
backend/app/api/v1/routes/auth.py - Paper repository → Domain models: queries paper model
backend/app/db/repositories/paper_repository.py - Project repository → Domain models: queries project model
backend/app/db/repositories/project_repository.py - Domain models → Relational database: persists domain data