How shrey-cs-ai/orbirag_app works
This repository implements Orbirag/Scholar Pulse, an academic research assistant with chat, literature search, paper management, citations, notes, methodology extraction, plagiarism analysis, and writing tools. A user’s research workflow enters the research API, which can search literature and save papers; separate chat and document routes support conversational answers and PDF Q&A. The research backend also exposes distinct research utilities and persistence services. Edges reflect shown calls, imports recorded in the SOURCE INDEX, or explicit service behavior; frontend application sources and some backend route details were not provided.
Main entry points: backend_research/main.py Research API · backend_chat/main.py Chat API · rag_service.py Document RAG · vector_store.py Vector store
Components 27
API entrypoints
- Research API
backend/backend_research/main.py - Chat API
backend/backend_chat/main.py - API contracts
backend/backend_research/schemas.py - Chat contracts
backend/backend_chat/models.py
Research workflow
- Literature search
backend/backend_research/services/search_service.py - Paper library
backend/backend_research/services/library_service.py - Citation tools
backend/backend_research/services/citation_service.py - Methodology extraction
backend/backend_research/services/methodology_service.py - Plagiarism tools
backend/backend_research/services/plagiarism_service.py - Research notes
backend/backend_research/services/notes_service.py - Document RAG
backend/backend_research/services/rag_service.py - PDF processing
backend/backend_chat/services/pdf_service.py
AI assistance
- Embedding service
backend/backend_research/services/embedding_service.py - AI chat service
backend/backend_chat/services/ai_service.py - Voice transcription
backend/backend_chat/services/deepgram_service.py - Text analysis
backend/backend_chat/services/word_counter_service.py
Persistence and identity
- Vector store
backend/backend_research/vector_store.py - SQL database access
backend/backend_research/database.py - Research queries
backend/backend_research/db_queries.py - User management
backend/backend_research/services/user_service.py - Token verification
backend/backend_chat/services/auth_service.py
Other components
- Semantic Scholar
- Gemini
- Deepgram
- Firebase Auth
- PostgreSQL
- DuckDB VSS
Connections 25
- Research API → Literature search: searches with
backend/backend_research/main.py - Literature search → Semantic Scholar: queries
backend/backend_research/services/search_service.py - Research API → Paper library: manages papers
backend/backend_research/main.py - Research API → Citation tools: routes citation work
backend/backend_research/main.py - Research API → Methodology extraction: requests extraction
backend/backend_research/main.py - Research API → Plagiarism tools: runs checks
backend/backend_research/main.py - Research API → Research notes: manages notes
backend/backend_research/main.py - Research API → Document RAG: routes document Q&A
backend/backend_research/main.py - Research API → Research queries: saves records
backend/backend_research/main.py - Research API → User management: manages users
backend/backend_research/main.py - Research API → SQL database access: opens sessions
backend/backend_research/main.py - Document RAG → Vector store: indexes and searches
backend/backend_research/services/rag_service.py - Document RAG → AI chat service: asks with context
backend/backend_research/services/rag_service.py - Vector store → Embedding service: uses embeddings
backend/backend_research/vector_store.py - Vector store → DuckDB VSS: stores vectors
- Chat API → AI chat service: gets responses
backend/backend_chat/main.py - Chat API → Voice transcription: transcribes audio
backend/backend_chat/main.py - Chat API → PDF processing: extracts PDF text
backend/backend_chat/main.py - Chat API → Text analysis: builds statistics
backend/backend_chat/main.py - AI chat service → Gemini: generates answers
backend/backend_chat/services/ai_service.py - Voice transcription → Deepgram: transcribes audio
backend/backend_chat/services/deepgram_service.py - Token verification → Firebase Auth: verifies tokens
backend/backend_chat/services/auth_service.py - SQL database access → PostgreSQL: connects to
backend/backend_research/database.py - Research API → API contracts: uses schemas
backend/backend_research/main.py - Chat API → Chat contracts: uses models
backend/backend_chat/main.py