# 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.