old_rag
Zero-admin sovereign local Outlook and filesystem hybrid RAG engine powered by Scryer (>=0.2.0) and AuraRouter (>=0.5.8).
Architecture & Core Invariants
- Sovereign Local Execution: Runs 100% locally on standard Windows workstations without administrative privileges.
- Unified Extraction via Scryer:
- Deterministic Phase 1 parsing and AuraRouter Phase 2 multi-modal enrichment run through
scryer(old_rag.engine.extractor.DocumentExtractor) across.pdf,.docx,.xlsx,.pptx,.eml,.msg, images (.png,.jpg,.webp,.bmp,.tiff), and plain-text formats. settings.json["aurarouter"]maps directly intoScryerExtractionOptions(enabled,mode,endpoint_url,config_path,local_only,timeout_sec, and optionalvision_role).HeadOfFolderIndex(old_rag.engine.folder_index) uses Scryer Phase 1 deterministic extraction so shared-folder scans index real text from binary documents rather than raw binary bytes.
- Deterministic Phase 1 parsing and AuraRouter Phase 2 multi-modal enrichment run through
- Multi-Process Runtime:
old-rag daemon: Background coordinator handling MAPI polling,DirectoryWatcherfilesystem monitoring, two-phase outbox recovery, FTS5 + LanceDB indexing, and local named-pipe IPC (ingest_path,search,status,reindex,save_settings, etc.).old-rag ui: Nativepywebviewcompanion overlay communicating over local named pipes with in-process fallback (zero listening HTTP sockets).old-rag mcp: FastMCP stdio server exposing archive search and retrieval tools to AuraRouter or external agents.
- Envelope Encrypted CAS:
- Master Data Encryption Key (DEK) protected via Windows DPAPI (
win32crypt.CryptProtectData). - Three-tier content-addressable storage (
texts/,blobs/,msgs/) using AES-256-GCM with HMAC-SHA256 obfuscated filenames. - Normalized
NormalizedDocumentJSONarchives enable 100% offline re-indexing without re-reading Outlook or re-running VLMs.
- Master Data Encryption Key (DEK) protected via Windows DPAPI (
- Centralized Schemas (
old_rag.schema, Schema v2):- SQLite
catalog.db(CURRENT_SCHEMA_VERSION = 2) with composite-keyedvlm_cache (blob_hash, template_key, schema_hash)and searchabledocument_entities (doc_id, entity_key, entity_value, source_filename)tables, plus automatic v1 -> v2 migration. - Dual SQLite FTS5 lexical indexes (
chunks_fts_porter&chunks_fts_trigram) paired with Matryoshka-reduced (nomic-embed-text-v1.5) vectors in LanceDB (chunks_vec).
- SQLite
Installation & Testing
Requires Python 3.12+ and installed scryer + aurarouter.
pip install -e .
Run the unit and E2E test suite:
pytest -q
CLI Usage
# Initialize DPAPI-protected DEK, CAS storage, and catalog schema
old-rag init
# Start background coordinator daemon + named pipe IPC + configured DirectoryWatcher
old-rag daemon
# Ingest a local directory or single file (PDF, DOCX, XLSX, PPTX, EML, MSG, images)
old-rag ingest --path "C:\Users\you\Documents\Reports"
# Ingest only direct children of a folder (non-recursive)
old-rag ingest --path "C:\Users\you\Documents\Invoices" --no-recursive
# Ingest Classic Outlook MAPI mail for the last 30 days
old-rag ingest --days 30 --folder Inbox
# Query status, trigger offline re-index, or purge zero-ref blobs
old-rag status
old-rag reindex
old-rag purge
# Launch UI overlay or FastMCP stdio server
old-rag ui
old-rag mcp
AuraRouter Configuration (settings.json)
In %LOCALAPPDATA%\OldRAG\settings.json:
{
"aurarouter": {
"enabled": true,
"mode": "auto",
"endpoint_url": "",
"config_path": "",
"role": "assist",
"local_only": true,
"timeout_sec": 30.0
}
}
enabled: Enables/disables Scryer Phase 2 VLM/LLM enrichment (enable_phase2).mode:"auto"/"embedded"(TriMode.PYTHON),"mcp_http"/"ipc"(TriMode.IPC), or"mas"(TriMode.MAS).local_only: Requests sovereign local model routing (prefer_local).config_path: Optional explicitauraconfig.yamloverride (aurarouter_config_path).vision_role(optional): Explicit AuraRouter role override for Phase 2 visual extraction (falls back to Scryer's default"vision_extraction"routing when unset or whenroleis"assist").
Metadata
Release files for old-rag 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| old_rag-0.1.0.tar.gz | 234.6 kB | With provenance | Details for old_rag-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| old_rag-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for old_rag-0.1.0-py3-none-any.whl |
Total release size: 447.9 kB
Release files / old_rag-0.1.0.tar.gz
| Download URL | old_rag-0.1.0.tar.gz |
|---|---|
| Size | 234.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
cb034c0fde7645da420c45967c12822d55c50f9e401355d7dd3a3aa09a4ca487
|
|
BLAKE2b-256 checksum How to use checksums |
a2ccd1e047463f93e2f330b95a8aae503831fff44566091bdeda9dda8365831c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.
Transparency logRelease files / old_rag-0.1.0-py3-none-any.whl
| Download URL | old_rag-0.1.0-py3-none-any.whl |
|---|---|
| Size | 213.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ae33e41dd8630f14acd2594ef6a292edf5f82fd9d25c8407bd9bfdad6f18104e
|
|
BLAKE2b-256 checksum How to use checksums |
df95c788702e4296852c544b97d9cdd08b6ceb168ea11bd78ad1473615819f66
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.
Transparency logSecurity for old-rag 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for old_rag-0.1.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.