How nav477/project-nomad works
Project NOMAD is an offline-first browser-accessible knowledge and education server. Users access the Command Center to install and manage services, explore offline content, use AI chat with uploaded documents, and configure system features; the backend coordinates containerized tools and resources. The graph also preserves documented capabilities for maps, education, Supply Depot, updates, setup, and benchmarking. Some subsystem links are documented only at product level; dashed edges mark links whose implementation wiring was not shown in the sampled source.
Main entry points: rag_service.ts Knowledge indexing and search · rag_pipeline_service.ts RAG pipeline · home.tsx Command Center UI · system_controller.ts Service management API
Components 21
Command Center
- Command Center UI
admin/inertia/pages/home.tsx - Service management API
admin/app/controllers/system_controller.ts - AI chat API
admin/app/controllers/chats_controller.ts - Knowledge API
admin/app/controllers/rag_controller.ts - Easy setup wizard
admin/app/controllers/easy_setup_controller.ts
Knowledge and AI
- RAG pipeline
admin/app/services/rag_pipeline_service.ts - Knowledge indexing and search
admin/app/services/rag_service.ts - Document storage
admin/app/utils/fs.ts - Model management
admin/app/services/ollama_service.ts - Qdrant vector store
- Offline information library
admin/app/services/kiwix_library_service.ts
Managed Services
- Docker services
admin/app/services/docker_service.ts - Service catalog
admin/database/seeders/service_seeder.ts - Offline maps
admin/app/services/map_service.ts - Supply Depot
admin/app/controllers/supply_depot_controller.ts - Education platform
- Data tools and notes
System Operations
- Automatic updates
admin/app/services/content_auto_update_service.ts - System benchmark
admin/app/services/benchmark_service.ts - System information
admin/app/services/system_service.ts
Other components
- Browser user
Connections 21
- Browser user → Command Center UI: uses
README.md - Command Center UI → Service management API: manages services
- Service management API → Docker services: orchestrates
README.md - Service catalog → Docker services: defines services
- Browser user → AI chat API: asks questions
README.md - AI chat API → RAG pipeline: runs chat
- Browser user → Knowledge API: uploads documents
README.md - Knowledge API → Knowledge indexing and search: delegates to
admin/app/controllers/rag_controller.ts - RAG pipeline → Knowledge indexing and search: searches with
admin/app/services/rag_pipeline_service.ts - RAG pipeline → Model management: requests models
admin/app/services/rag_pipeline_service.ts - Knowledge indexing and search → Qdrant vector store: queries vectors
admin/app/services/rag_service.ts - Knowledge indexing and search → Document storage: reads files
admin/app/services/rag_service.ts - Browser user → Offline information library: reads offline content
README.md - Browser user → Offline maps: explores maps
README.md - Browser user → Education platform: takes courses
README.md - Browser user → Data tools and notes: uses tools
README.md - Browser user → Supply Depot: browses catalog
README.md - Browser user → Easy setup wizard: configures NOMAD
README.md - Browser user → Automatic updates: configures updates
README.md - Browser user → System benchmark: runs benchmark
README.md - Browser user → System information: checks system