LocalIQ
Ask your files anything. Documents, PDFs, notes, images and code are indexed on the PC and answered with citations by on-device Phi Silica. Works offline. (It supersedes an earlier "Offline Spec Sheet Q&A" app.)
How it works
flowchart TB FILES[files / folders] --> EXT[Extractor<br/>PDF, DOCX, PPTX, XLSX, ODF, EPUB, RTF, ipynb, HTML, text] EXT -->|no text layer / image| OCR[Ocr: TextRecognizer<br/>optional ImageDescriptionGenerator] EXT & OCR --> CH[DocUnit → chunks] CH --> LEX[(BM25 lexical index)] CH --> SEM[(AppContentIndexer<br/>semantic index)] Q[question] --> HY[hybrid retrieval<br/>semantic + BM25] LEX & SEM --> HY HY --> P[grounded prompt] --> M[Phi Silica] M --> V[deterministic checks:<br/>numbers, citations, relevance] V --> A[answer + sources]
- Hybrid retrieval: semantic hits and BM25 keyword hits are merged, because each misses what the other finds (part numbers, exact figures).
- Guards: the answer's numbers are checked against the retrieved text, citations are verified, and irrelevant retrievals are refused (
verifyHtml,keysHtmlin the UI show the checks). - Office files are read entry by entry from the zip (only the XML parts), so embedded media is never loaded and size does not matter; scanned PDFs are rendered with the Windows PDF renderer and OCR'd.
Source files
| File | What it contains |
|---|---|
Engine.cs (SpecEngine) |
The whole backend: library store, indexing, AppContentIndexer use (always through Task.Run), tokenising + BM25, hybrid search, grounded prompt, verification. |
Extraction.cs |
Extractor: file-kind detection and text extraction per format; PDF line rebuild from word positions with | marking table columns; PdfPig. |
Ocr.cs |
TextRecognizer OCR and optional photo captioning from background threads; PDF page rendering for scanned PDFs. |
Models.cs |
Bridge DTOs (BridgeRequest/Response, DocInfo, ChunkRec, Hit, AskResult, IndexStatus…) and the JSON source-generation context. |
MainWindow.xaml.cs |
Bridge ops, model readiness, opening only files the library knows. Debug-only: a selftest.json in LocalState runs index → ask at start-up. |
www/index.html, www/app.js |
UI: library panel, scope selector, indexing progress, answer rendering with sources (ask, renderLibrary, runIndex, formatAnswer, sourcesHtml). |
tools/ |
Python scripts that generated the synthetic samples and icons (make_samples.py, make_samples_general.py, make_icons.py). |
sample-datasheets/, sample-files/ |
Invented component datasheets, and a mixed library: documents, a scanned PDF, a whiteboard photo, code, spreadsheets, slides. |
Step-by-step deployment
Everything below is copy-paste PowerShell on a Windows 11 PC. Replace nothing: the repository owner is medyabi.
1. Check the PC and install the tools (once)
- Windows 11 build 22621 or later, x64 (
winver). For the AI features you need a Copilot+ PC (NPU); otherwise the app starts but reports the model as unavailable.
winget install --id Microsoft.DotNet.SDK.8
winget install --id Git.Git
winget install --id GitHub.cli2. Sign in to GitHub and clone (the repository is private, so the account must have access)
gh auth login
git clone https://github.com/medyabi/windows-local-ai-apps.git
cd windows-local-ai-apps3. Build the signed package (about 30 s to 2 min; the first build also downloads NuGet packages and needs internet)
.\scripts\build-app.ps1 -App LocalIQAppIt creates a self-signed certificate if needed and writes two files: dist\LocalIQApp\LocalIQApp_1.0.0.0_x64.msix and dist\LocalIQApp\LocalIQApp.cer. A warning about mspdbcmf.exe is harmless.
4. Trust the certificate (PowerShell as administrator, once per PC)
Import-Certificate -FilePath .\dist\LocalIQApp\LocalIQApp.cer -CertStoreLocation Cert:\LocalMachine\TrustedPeople5. Install
Add-AppxPackage -Path .\dist\LocalIQApp\LocalIQApp_1.0.0.0_x64.msix6. Launch it from the Start menu (LocalIQ by Dyabi) or:
$p = Get-AppxPackage Dyabi.LocalIQ
Start-Process "shell:AppsFolder\$($p.PackageFamilyName)!App"7. First launch
- The status pill shows the on-device model state. The first time, Windows may need to prepare the model (a few minutes, may need Windows Update).
- Add the
sample-files/orsample-datasheets/folder to the library and wait for indexing to finish before asking questions.
8. If something fails
$p = Get-AppxPackage Dyabi.LocalIQ
notepad "$env:LOCALAPPDATA\Packages\$($p.PackageFamilyName)\LocalState\bridge.log"Common errors and fixes are in docs/DEPLOYMENT.md.
9. Uninstall (also removes the app's data)
Get-AppxPackage Dyabi.LocalIQ | Remove-AppxPackageTry it
- Add the
sample-files(orsample-datasheets) folder to the library and wait for the progress bar to finish. - Ask a factual question, e.g. about a figure in an invoice or datasheet; open a source to see the highlighted line.
- Turn on photo descriptions to include images that have no text.
Limits
Works offline once the Windows model is ready; the index is asynchronous (the app polls its status). Small context window: very broad questions retrieve only a few passages.