Repository navigation
feat: Open RAG, a Windows desktop app with categories and sections - #6
Merged
Merged
Conversation
- WPF shell (.NET 10) hosting a React 19 + Tailwind 4 interface in WebView2, in the AI Engineering Arena's sticker-arcade theme (light and dark, fonts bundled for offline use) - sidebar of categories and sections; per section: folders, background indexing with progress, documents and a chat; a category chat searches all its sections; citations as pills and source cards that open the file - the app starts ore serve itself (bundled Python when installed, uv in a checkout), ties it to a job object and routes every API call through an EngineProxy that adds the token and allows only the engine's API paths, so the page never sees the token or talks to a local port - conversations kept per section on this computer; follow-up questions use the recent history - ore serve: --data-dir and --warm; python -m open_rag_engine - tests: 36 .NET (engine start, ready line, locator, proxy, safe file opening), 13 web, engine suite; Windows CI job
The standard Windows title bar is replaced by one drawn in the Arena's top-bar style: the RAG sticker, the app name, where you are (category > section) and Arena window buttons. It is a WebView2 drag region, so dragging, double-click to maximise and the window menu still work; WindowChrome keeps resizing from a thin border, rounded corners on Windows 11, and the frame follows light or dark mode.
The global keyboard-focus outline was unlayered CSS, so it beat the text area's outline-none and drew a rectangle inside the rounded box. It now lives in the base layer, and the whole box shows focus with a cobalt border and shadow.
A bundled engine loads its models from models_dir/<org>--<name> under the same model names, so the index fingerprint and existing indexes stay valid. --llm-url points the engine at the llama-server the app starts.
- chat: a late reply after switching section can no longer land in, or be saved under, another conversation; saving is debounced and done outside the state update; the chat resets if the engine restarts (+ regression tests) - a connection lost mid-answer becomes a 503 instead of an unhandled exception; every forwarded call and question now always gets an answer for its id; library calls time out instead of hanging - opening sources: only local document paths (no UNC, device or alternate-stream paths), checked off the UI thread; explorer.exe by full path - engine lifecycle: start and restart are serialised, deliberate stops aren't reported as crashes, a start that times out stops the process, only the current engine can report a crash, and unexpected start errors show a message - WebView2: content-security policy on the built page (connect-src 'none'), DenyCors mapping, all permissions denied, no host objects; HttpClient bypasses system proxies - engine: Stop now really stops generation (the next token raises once the client is gone); models load once under a lock, so the warm-up and a first question can't load them twice - proxy: exact allow-list match (\z), questions only via the stream, problem bodies built with a JSON serialiser - deleting a section or category also deletes its saved conversation; checkout discovery is Debug-only
The Python .gitignore template ignored every lib/ folder, so desktop/web/src/lib (the engine client, the WebView2 bridge, chat storage, the mock engine and their tests) never reached the repository and a fresh checkout couldn't build the interface. The rule now covers only the root lib/ and lib64/.
installer/build.py stages a self-contained Open RAG and runs Inno Setup: the published app, a uv-managed CPython 3.12 with the engine and its locked dependencies (CPU torch), the embedding and reranker models from the Hugging Face cache, the Qwen3 GGUF from Ollama (digest-checked) and llama.cpp's llama-server (pinned b12052, sha256-checked). The setup installs per user, keeps the library on uninstall and comes in parts below GitHub's 2 GiB limit. The app starts the bundled llama-server on a free loopback port with its own key and points the engine at it with --llm-url. ChildHost replaces EngineHost and runs both processes, waiting on ORE_READY or a /health probe. Logs rotate at 5 MB. installer/smoke_test.py checks a stage or an installed app end to end. The window also opens the credits' GitHub and LinkedIn links, and only those (ExternalLinks).
The sidebar says who developed Open RAG and opens a Credits sheet with both authors' GitHub and LinkedIn and the source code. Links open in the default browser through the window, which accepts only the links on its own list; a test checks the sheet's links against it.
5 of 6 tasks
feat: Windows installer with a bundled language model, plus credits
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Open RAG, the Windows desktop app (step 2 of 3), in
desktop/. It is for teachers, researchers and students:It runs entirely on the computer. The self-contained installer is the next PR.
What it looks like:
What you can do in it:
How it is built (ADR-0007, updated here):
OpenRag.App(WPF, .NET 10):https://app.ore).ore serveitself, with a new 256-bit token per launch, and ties it to a job object. Closing the app stopped the engine in testing.EngineProxyadds the token and allows only the engine's API paths and methods, and answers stream back line by line.127.0.0.1.OpenRag.Core:uv run.ORE_READY port=Nand writes the engine's output to%LOCALAPPDATA%\OpenRag\logs\engine.log..pdf,.md,.txt) that exist, by absolute path, so nothing the page sends can launch a program.web/: React 19, Tailwind 4 and motion, with a mock engine, so the interface can be designed in a browser with no Python.ore serve --data-dirkeeps the app's data in%LOCALAPPDATA%\OpenRag.--warmloads the models in the background, so the first question doesn't wait.python -m open_rag_engineis how the installed app will start it.Stacked on #5 (which is on #4). Merge those first.
Why
Wadi asked for an offline WPF app for teachers, researchers and students, with sections and categories, in the Arena's look.
How it was tested
.., other hosts and other methods), the token, streaming and 503s;tscand ESLint.OpenRag.exestarted the engine. The models loaded fully offline: the log shows it refused to contact Hugging Face.Checklist
docs/, or a new ADR for architectural decisions)