Skip to content

README-Portability.md

Latest commit

 

History

History
43 lines (28 loc) · 3.15 KB

README-Portability.md

File metadata and controls

43 lines (28 loc) · 3.15 KB
Raw

Portability & Model-Agnostic Design

Everything in this project is built to run on any PC, in any modern browser, with no AI model required at runtime. This note states exactly what that means and where the one optional dependency lives.

The core guarantee

The query and search tools are deterministic engines, not AI models. When you ask "what is reinforcement learning?" the answer is computed by plain JavaScript scoring over the term data, not generated by a language model. That means:

  • No API key, no account, no sign-in.
  • No internet connection needed (one exception below: the 3D map's library).
  • No external service that could change, rate-limit, or go away.
  • Identical results on any machine: same question, same answer, every time.

This is the "agnostic regardless of model or user" principle made literal. The tools do not depend on Claude, GPT, or any other model to function. They are self-contained HTML files you can email, copy to a USB drive, or open from your desktop.

What each file needs

File Runs offline? Needs a model? Notes
Agentic-AI-Governance-Glossary.md Yes No Plain text/markdown, opens anywhere.
terms.enriched.json Yes No The single source of truth. Model-neutral data.
Agentic-AI-Governance-Reflections.html Yes No Self-contained 2D view. Double-click to open.
Agentic-AI-Governance-Query.html Yes No Self-contained structural query console.
Agentic-AI-Governance-Chat.html Yes No Self-contained search engine (deterministic retrieval, not an LLM).
Agentic-AI-Governance-Map.html Partly No 2D layered view works fully offline. The 3D view needs the Three.js library (see below).

The one optional dependency: the 3D map

The 3D map uses the Three.js graphics library. The file looks for it in this order:

  1. A local file named three.min.js sitting in the same folder as the map. (Best for offline.)
  2. Public CDNs (needs internet).
  3. If neither is available, it automatically shows the same map as a flat 2D layered list, so the file is never broken.

To make the 3D map work fully offline on any PC: download three.min.js (version r128) once from https://cdnjs.cloudflare.com/ajax/libs/three.js/r128/three.min.js and save it next to Agentic-AI-Governance-Map.html. After that, no internet is ever needed.

How to run anything here

Double-click any .html file. It opens in your default browser and works immediately. To move the whole project to another computer, copy the folder. Nothing to install.

If you ever want to add a model on top

The tools are model-agnostic by default, but the design also makes it easy to plug a model in later without locking to one. Every tool reads the same terms.enriched.json. That structured file is the clean interface: any model (Claude, GPT, a local open-source model, or a future one) can read the same JSON and answer over the same ground truth. The deterministic engines stay as the verifiable floor; a model, if added, sits on top as an optional convenience, never as a requirement. That keeps the "winning" property you wanted: the structure is the source of truth, and no single model owns the meaning.