How jorgepb96/nodus works
Nodus Research is a local-first desktop workspace for research, teaching, study, and structured data. Users work in focused vaults, bringing sources and materials into a workspace and using its research, learning, and data tools; the README also describes Zotero integration and optional online or local AI. The graph preserves those product areas and the sampled embedding, document-extraction, and database-research layers. Several domain implementations are represented by their exact directories because their source was not sampled; edges between those areas are omitted where the evidence does not establish runtime calls.
Main entry points: main.ts Nodus Desktop · database.ts Vault Database · embeddingPipeline.ts Embedding Pipeline · settingsRepo.ts Vault Settings
Components 20
Desktop Workspace
- Nodus Desktop
electron/main.ts - Shared UI Components
src/components/ui.tsx - Pipeline Logging
electron/logging/pipelineLogCore.ts
Research Work
- Academic Research
electron/ai - Library Extraction
electron/library/libraryExtractionEngine.ts - Zotero Integration
electron/zotero - Family Research
electron/ai/genealogyDeepResearch.ts - Database Research
shared/databaseResearchEngine.ts
Teaching And Study
- Teaching Tools
electron/ai/teachingRubrics.ts - Study Tools
electron/ai/studyAssistant.ts
Vault Data
- Database Workspace
electron/db - Vault Database
electron/db/database.ts - Ideas Repository
electron/db/ideasRepo.ts - Vault Settings
electron/db/settingsRepo.ts - Embedding Index Store
electron/db/embeddingIndexesRepo.ts
AI And Search
- Embedding Pipeline
electron/ai/embeddingPipeline.ts - AI Client
electron/ai/aiClient.ts - Local AI
electron/ai/nodusLocalAi.ts - Embedding Provenance
electron/ai/embeddingProvenance.ts
Other components
- Researcher Or Learner
Connections 18
- Researcher Or Learner → Nodus Desktop: uses
README.md - Nodus Desktop → Academic Research: offers research
README.md - Nodus Desktop → Family Research: offers genealogy
README.md - Nodus Desktop → Database Workspace: offers databases
README.md - Nodus Desktop → Teaching Tools: offers teaching
README.md - Nodus Desktop → Study Tools: offers study
README.md - Academic Research → Zotero Integration: integrates Zotero
README.md - Library Extraction → Vault Database: uses storage
- Embedding Pipeline → AI Client: requests embeddings
electron/ai/embeddingPipeline.ts - Embedding Pipeline → Vault Database: reads and writes
electron/ai/embeddingPipeline.ts - Embedding Pipeline → Ideas Repository: reads idea text
electron/ai/embeddingPipeline.ts - Embedding Pipeline → Vault Settings: reads configuration
electron/ai/embeddingPipeline.ts - Vault Settings → Vault Database: uses database
electron/db/settingsRepo.ts - Vault Settings → Embedding Index Store: loads index state
electron/db/settingsRepo.ts - Ideas Repository → Vault Database: uses database
electron/db/ideasRepo.ts - Database Research → Vault Database: loads research state
shared/databaseResearchEngine.ts - AI Client → Vault Settings: reads settings
electron/ai/aiClient.ts - AI Client → Local AI: supports local models
electron/ai/aiClient.ts