How ranidnu-w/nexus works
Nexus is a self-hosted multi-agent AI platform: users work through a Next.js interface, while n8n workflows provide document ingestion and Q&A, review analysis, intent routing, digests, analytics, health checks, cleanup, and job status. The frontend pages call a shared API client; README-described workflows connect to local inference, retrieval, and state services. Workflow internals and API endpoint mappings were not sampled, so those relationships are limited to documented capabilities or marked unverified.
Main entry points: api.ts Frontend API client · page.tsx DocMentor UI · Nexus_File Intake Pipeline.json File intake · Nexus_DocMentor RAG Agent.json DocMentor RAG
Components 25
User interface
- Home
frontend/src/app/page.tsx - Dashboard
frontend/src/app/dashboard/page.tsx - Agent chat
frontend/src/app/chat/page.tsx - File upload
frontend/src/app/files/page.tsx - DocMentor UI
frontend/src/app/docmentor/page.tsx - Review UI
frontend/src/app/review/page.tsx - Digest UI
frontend/src/app/digest/page.tsx - Analytics UI
frontend/src/app/analytics/page.tsx - System status UI
frontend/src/app/status/page.tsx - Frontend API client
frontend/src/lib/api.ts
Agent workflows
- File intake
n8n-workflows/Nexus_File Intake Pipeline.json - DocMentor RAG
n8n-workflows/Nexus_DocMentor RAG Agent.json - Review analyst
n8n-workflows/Nexus_Review Analyst.json - Intent orchestrator
n8n-workflows/Nexus_Orchestrator.json - Digest agent
n8n-workflows/Nexus_Digest Agent.json
Platform operations
- Health monitor
n8n-workflows/Nexus_System Health Monitor.json - Interaction analytics
n8n-workflows/Nexus_Interaction Analytics.json - Cleanup workflow
n8n-workflows/Nexus_Cleanup Workflow.json - Job status endpoint
n8n-workflows/Nexus_Job Status Endpoint.json
AI and data services
- Ollama inference
- Docling parser
- Qdrant vector store
- Airtable state
- RSS feeds
Other components
- User
Connections 31
- User → Home: opens platform
README.md - User → Dashboard: uses features
README.md - Agent chat → Frontend API client: sends messages
frontend/src/app/chat/page.tsx - Agent chat → Frontend API client: polls job status
frontend/src/app/chat/page.tsx - File upload → Frontend API client: uploads files
frontend/src/app/files/page.tsx - File upload → Frontend API client: polls job status
frontend/src/app/files/page.tsx - DocMentor UI → Frontend API client: queries documents
frontend/src/app/docmentor/page.tsx - DocMentor UI → Frontend API client: uploads files
frontend/src/app/docmentor/page.tsx - DocMentor UI → Frontend API client: polls job status
frontend/src/app/docmentor/page.tsx - Review UI → Frontend API client: submits review
frontend/src/app/review/page.tsx - Digest UI → Frontend API client: configures digest
frontend/src/app/digest/page.tsx - Digest UI → Frontend API client: loads latest
frontend/src/app/digest/page.tsx - Analytics UI → Frontend API client: loads metrics
frontend/src/app/analytics/page.tsx - System status UI → Frontend API client: checks health
frontend/src/app/status/page.tsx - Dashboard → Frontend API client: loads status and metrics
frontend/src/app/dashboard/page.tsx - Frontend API client → Intent orchestrator: routes requests
- Intent orchestrator → DocMentor RAG: routes intent
README.md - Intent orchestrator → Review analyst: routes intent
README.md - File intake → Docling parser: parses documents
README.md - File intake → Ollama inference: creates embeddings
README.md - File intake → Qdrant vector store: stores vectors
README.md - DocMentor RAG → Qdrant vector store: retrieves vectors
README.md - DocMentor RAG → Ollama inference: generates answers
README.md - Review analyst → Ollama inference: analyzes reviews
README.md - Digest agent → RSS feeds: reads feeds
README.md - Digest agent → Ollama inference: summarizes content
- Health monitor → Airtable state: records health
- Interaction analytics → Airtable state: aggregates usage
README.md - Cleanup workflow → Qdrant vector store: prunes vectors
README.md - Cleanup workflow → Airtable state: archives records
README.md - Job status endpoint → Airtable state: reads job status