EdgeReco on GitHub

The EdgeReco stack

• hseshadr/edge-reco — Product search and recommendations that run on the shopper's device: a 720-product catalog ships as a 1.6 MB signed, content-addressed bundle, then MiniLM semantic search, rank fusion and session-aware reranking all run in the tab. Zero backend calls after sync. 984 tests.
• hseshadr/edge-proc — Ship a search index to a device as signed, content-addressed bundles: fail-closed Ed25519 verification, FastCDC chunking so the next release downloads only the chunks that changed, then FAISS + BM25 rank fusion locally. Python. 309 tests, 98% coverage. EdgeReco is built on it.
• hseshadr/edgeproc-core — Decides which partition a vector belongs in when a vector index is split across tenants, users, or time windows: three routing strategies plus result merge-back, one runtime dependency (pydantic), no index of its own. 243 tests, 98% coverage. On PyPI as edgeproc-core.

Other repositories by the same maintainer

• hseshadr/aml-filter — Screen a name against 31,566 sanctioned entities — OFAC SDN, EU, UN and UK OFSI — entirely inside your browser tab. Signed watchlist bundles with fail-closed Ed25519 verification, explainable fuzzy matching, and customer records that never leave SQLite-WASM on your own disk. 1,215 tests. Live at aml-filter.com.
• hseshadr/privacy-core — Redact PII in the browser before a prompt ever leaves the machine, then rehydrate the reply locally: 11 entity types, Luhn/SSN/IBAN checksum validation, and a type-checked Egress Guard on the send path. TypeScript. 173 tests, 100% coverage.
• hseshadr/assay — Sign a decision record with Ed25519 over RFC 8785 canonical JSON, then verify it offline years later — shipped as avow on PyPI and @edgeproc/avow on npm. 12 shared golden vectors prove Python and TypeScript emit byte-identical signatures. 198 tests, 100% branch coverage.
• hseshadr/almamesh — Free Vedic astrology that runs the entire Python engine inside your browser via Pyodide — Skyfield with the DE421 JPL kernel, 19 classical yoga rules, 900 engine tests. No account, no server call after first load, works offline. Optional bring-your-own-key AI narration. Live at almamesh.com.
• hseshadr/ci — The GitHub Actions the edgeproc repos share instead of each hand-rolling: 7 reusable workflows + 5 composite actions for gates, secret scanning, dependency audit, OIDC publish to PyPI/npm, and Pages deploy. Every uses: is SHA-pinned; a scheduled job reports the 29 controls consumers still hand-roll.

Project facts

Name: EdgeReco

Also written as: Edge-Reco, edge-reco

Repository: hseshadr/edge-reco on GitHub

Maintainer: hseshadr

Category: open-source browser-first product recommendation engine

Runtime: web browser / local-first execution

Core techniques: signed, content-addressed catalog bundles verified fail-closed; BM25 keyword search; FAISS vector search; Reciprocal Rank Fusion; session-aware reranking

Demo store: Nimbus (a fictional demo storefront used only to showcase EdgeReco)

Live sites

• edge-reco.com — the EdgeReco demo storefront (this site).
• aml-filter.com — sanctions screening in the browser tab.
• almamesh.com — the Python astrology engine running in the browser via Pyodide.