How shivanshpandey2005/nexusrag works
NexusRAG combines a Next.js enterprise knowledge-management console with a FastAPI RAG backend. The main workflow is document upload, parsing and chunking, embedding and indexing, followed by multi-agent retrieval and query answering; the UI also presents search, graph, analytics, observability, workspace and compliance capabilities. The frontend’s mock data and authentication are visible in sampled files. Some backend internals and UI-to-backend wiring were not sampled, so the graph avoids asserting an unverified connection between them.
Main entry points: main.py FastAPI endpoints · db-mock.ts Mock enterprise data · auth-context.tsx Auth context · app-shell.tsx App shell
Components 30
Enterprise Console
- App shell
src/components/app-shell.tsx - Command menu
src/components/command-menu.tsx - Operations dashboard
src/app/dashboard/page.tsx - Enterprise search
src/app/search/page.tsx - Document center
src/app/documents/page.tsx - Knowledge graph explorer
src/app/graph/page.tsx - Knowledge bases
src/app/knowledge-bases/page.tsx - Analytics
src/app/analytics/page.tsx - Observability
src/app/observability/page.tsx - Workspaces and access
src/app/workspaces/page.tsx - Workflows
src/app/workflows/page.tsx - Compliance settings
src/app/settings/page.tsx - Mock enterprise data
src/lib/db-mock.ts
Authentication
- Auth context
src/context/auth-context.tsx - Login and signup
src/app/login/page.tsx - Login endpoint
src/app/api/auth/login/route.ts - Signup endpoint
src/app/api/auth/signup/route.ts - Session endpoint
src/app/api/auth/me/route.ts - Mock JWT
src/lib/jwt-mock.ts
Backend API
- FastAPI endpoints
backend/main.py - Rate limiter
backend/rate_limiter.py - Backend configuration
backend/config.py
Ingestion and Indexing
- Document parsers
backend/parsers.py - Semantic chunker
backend/chunker.py - Dense and sparse embeddings
backend/embeddings.py - Vector store
backend/vector_store.py
Retrieval and Memory
- Multi-agent orchestrator
backend/multi_agent.py - Hybrid retrieval and reranking
backend/retrieval.py - Conversation and cache memory
backend/memory.py
Other components
- Enterprise user
Connections 41
- Enterprise user → App shell: uses console
README.md - App shell → Command menu: renders
src/components/app-shell.tsx - App shell → Auth context: checks session
src/components/app-shell.tsx - Enterprise user → Enterprise search: searches knowledge
README.md - Enterprise user → Document center: manages documents
README.md - Enterprise user → Knowledge graph explorer: explores graph
README.md - Enterprise user → Operations dashboard: monitors operations
README.md - Enterprise user → Analytics: views analytics
README.md - Enterprise user → Observability: inspects traces
README.md - Enterprise user → Workspaces and access: manages access
README.md - Enterprise user → Workflows: manages workflows
README.md - Enterprise user → Compliance settings: sets guardrails
README.md - Operations dashboard → Mock enterprise data: reads data
src/app/dashboard/page.tsx - Enterprise search → Mock enterprise data: reads data
src/app/search/page.tsx - Document center → Mock enterprise data: reads data
src/app/documents/page.tsx - Knowledge graph explorer → Mock enterprise data: reads data
src/app/graph/page.tsx - Knowledge bases → Mock enterprise data: reads data
src/app/knowledge-bases/page.tsx - Analytics → Mock enterprise data: reads data
src/app/analytics/page.tsx - Observability → Mock enterprise data: reads data
src/app/observability/page.tsx - Workspaces and access → Mock enterprise data: reads data
src/app/workspaces/page.tsx - Login and signup → Auth context: uses auth
src/app/login/page.tsx - Auth context → Login endpoint: posts credentials
src/context/auth-context.tsx - Auth context → Signup endpoint: posts signup
src/context/auth-context.tsx - Auth context → Session endpoint: checks session
src/context/auth-context.tsx - Login endpoint → Mock JWT: signs token
src/app/api/auth/login/route.ts - Signup endpoint → Mock JWT: signs token
src/app/api/auth/signup/route.ts - Session endpoint → Mock JWT: verifies token
src/app/api/auth/me/route.ts - Enterprise user → FastAPI endpoints: uploads or queries
README.md - FastAPI endpoints → Rate limiter: rate limits routes
backend/main.py - FastAPI endpoints → Document parsers: parses uploads
backend/main.py - FastAPI endpoints → Semantic chunker: chunks content
backend/main.py - FastAPI endpoints → Vector store: indexes vectors
backend/main.py - FastAPI endpoints → Multi-agent orchestrator: executes query
backend/main.py - FastAPI endpoints → Conversation and cache memory: checks service health
backend/main.py - Multi-agent orchestrator → Hybrid retrieval and reranking: retrieves candidates
backend/multi_agent.py - Multi-agent orchestrator → Conversation and cache memory: uses conversation memory
backend/multi_agent.py - Hybrid retrieval and reranking → Vector store: searches vectors
backend/retrieval.py - Hybrid retrieval and reranking → Dense and sparse embeddings: embeds queries
backend/retrieval.py - Semantic chunker → Backend configuration: reads defaults
backend/chunker.py - Dense and sparse embeddings → Backend configuration: reads model settings
backend/embeddings.py - Vector store → Backend configuration: reads store settings
backend/vector_store.py