How doniadithya07/intelli-file works
IntelliFile is an offline Windows desktop file-search and question-answering product. A user searches or asks from the desktop UI; the local Python API routes the request to text, metadata, or visual retrieval and returns results or cited answers. Separately, selected folders are scanned and watched, files are extracted into passages, and keyword and vector indexes are maintained. Activity-based ranking and Windows Recent import are additional capabilities. The README documents these flows; several subsystem links below use enclosing paths because their implementation was not sampled.
Main entry points: service.py Text search · indexer.py Indexing service · main.py Local API · loop.py Question answering
Components 24
Desktop experience
- Desktop app
desktop/src/App.tsx - Search and pages
desktop/src/pages/SearchPage.tsx - Voice capture
desktop/src/hooks/useVoice.ts - Backend client
desktop/src/backend.ts
File indexing
- Folder watch
backend/app/files/service.py - Indexing service
backend/app/indexing/indexer.py - Content extraction
backend/app/extraction/extractor.py - Passage chunking
backend/app/chunking/chunker.py - Text embeddings
backend/app/embeddings/model.py - Visual indexing
backend/app/indexing/visual_indexer.py
Search and retrieval
- Local API
backend/app/main.py - Text search
backend/app/search/service.py - Query parsing
backend/app/search/query_parsing.py - Search routing
backend/app/search/router.py - Photo and video search
backend/app/visual_search/service.py
Assistant and memory
- Question answering
backend/app/agent/loop.py - Local language model
backend/app/agent/llm.py - Activity and profile
backend/app/context/profile.py
Local persistence
- Keyword index
backend/app/storage/keyword_store.py - Vector index
backend/app/storage/lancedb_store.py - File records
backend/app/storage/sqlite_store.py
Other components
- User
- Selected files
- Windows Recent items
Connections 31
- User → Desktop app: uses
- Desktop app → Search and pages: renders
- Search and pages → Backend client: requests search
- Voice capture → Backend client: sends recording
- Backend client → Local API: HTTP requests
- Local API → Text search: dispatches search
- Local API → Photo and video search: dispatches visual query
- Local API → Question answering: dispatches question
- Local API → Folder watch: manages folders
- Local API → Activity and profile: serves activity
- Folder watch → Selected files: scans and watches
- Folder watch → Indexing service: queues file jobs
- Indexing service → Content extraction: extracts content
- Indexing service → Passage chunking: chunks content
- Indexing service → Text embeddings: embeds passages
- Indexing service → Keyword index: writes terms
- Indexing service → Vector index: writes vectors
- Indexing service → File records: updates records
- Visual indexing → Vector index: writes visual vectors
- Text search → Query parsing: parses query
- Text search → Search routing: selects tier
- Text search → Keyword index: retrieves terms
- Text search → Vector index: retrieves vectors
- Text search → File records: reads file metadata
- Photo and video search → Vector index: retrieves visual matches
- Photo and video search → File records: reads file records
- Question answering → Text search: retrieves passages
- Question answering → Local language model: generates answer
- Question answering → File records: checks cited files
- Text search → Activity and profile: personalizes ranking
- Windows Recent items → Activity and profile: seeds activity