fallcompass ·κ=1

SOVEREIGN LLM CASCADE · FIRST SUCCESS WINS
8 PROVIDERS AUTO-FAILOVER BYOK WEBLLM LOCAL OLLAMA LOCAL MIT

If Anthropic gates · if OpenAI ToS shifts · if your favourite LLM provider rate-limits you on a Sunday night · fallcompass keeps your tool alive.

"One drop-in script. Eight LLM providers. The cascade tries them in your preferred order. First success wins. Your sovereign tool never depends on a single vendor's mood."

fallcompass is the answer to "what happens to my AI app the day OpenAI shuts you down." It's a 6KB shim you paste into any HTML file. It tries Ollama (free, local) → fallcore (your self-hosted proxy) → Anthropic → OpenRouter → Gemini → OpenAI → Mistral → WebLLM (in-browser, no key) — in whatever order you want, with whatever keys you have. The first one that responds, wins.

Why this exists

What kills SaaS-AI appsfallcompass response
OpenAI deprecates GPT-4 endpointCascade falls through to Claude / Gemini / local
Anthropic adds country blockCascade falls through to OpenRouter / Mistral / local
Your API key gets rate-limitedCascade falls through to next provider · user sees no error
Provider injects new "safety" filter you can't bypassCascade falls through to less-filtered alternative
Internet is downWebLLM in-browser kicks in · zero network
Your client doesn't trust paid APIsDefault to Ollama (their hardware, their model, their key)

Live · what's reachable from your browser right now

◊ provider probe

Click probe to see which LLM providers are reachable from this device. Local ones (Ollama, WebLLM) need no key. Cloud ones (Anthropic, OpenAI, etc.) need your BYOK.

Live · send a real prompt through the cascade

◊ cascade test

Type a prompt. Click ASK. fallcompass tries your preferred provider order. First one that responds, wins. You'll see which provider answered + how long it took.

Drop into ANY sovereign tool · 2 lines

<script src="https://sjgant80-hub.github.io/fallcompass/fallcompass-shim.js"></script>
<script>
  const r = await FallCompass.chat({ messages: [{ role:'user', content:'hi' }] });
  console.log(r.provider, '·', r.ms, 'ms', '·', r.reply);
</script>

That's it. Your tool now has 8-provider failover. FallCompass.setKey('anthropic','sk-ant-...') sets a key for that provider (stored in localStorage). FallCompass.probe() returns which providers are reachable.

Preferred cascade order (default)

  1. ollama — local server, free, no rate limit, your hardware
  2. fallcore — self-hosted Anthropic-compat proxy (also free if running)
  3. anthropic — Claude (requires API key OR Claude Code subscription)
  4. openrouter — has free-tier models like llama-3.2-3b-instruct:free
  5. gemini — Google · generous free tier
  6. openai — GPT-4o-mini · cheap and fast
  7. mistral — European, lighter filtering
  8. webllm — in-browser via @mlc-ai/web-llm CDN · WebGPU · zero network

Override the order per-request:

FallCompass.chat({
  messages: [...],
  preferredOrder: ['webllm','ollama','anthropic']
});

Threat-defended scenarios

FAQ

Does fallcompass send my prompts anywhere?

Only to the LLM provider you have a key for. Never to a fallcompass server (there is none). Open the Network tab — verify yourself.

Where are my API keys stored?

In your browser's localStorage, under fallcompass.<provider>.key. They never leave the device. Clearing browser data wipes them.

Can I disable specific providers?

Yes — pass preferredOrder to chat() with only the providers you want, in your preferred sequence.

What about streaming?

v1.0 is non-streaming for simplicity. v1.1 (next) will add streaming on a per-adapter basis.

Is this the same as fallcore?

No. fallcore is a self-hosted Anthropic-compatible proxy (one provider, your hardware). fallcompass is a browser-side cascade router (8 providers, automatic failover). They mesh: fallcore is one of fallcompass's adapters.

Is the shim safe to load from a CDN?

It's hosted on GitHub Pages, which serves it from GitHub's infrastructure. If you don't trust that, vendor-copy the file into your own tool — it's 6KB, zero dependencies.

Estate ripple · the dual move

Every tool in the AI Native Solutions estate that currently uses a single LLM provider will get fallcompass injected. Same line:

<script src="https://sjgant80-hub.github.io/fallcompass/fallcompass-shim.js"></script>

After ripple: if Anthropic gates the subscription · ShadowCompass, FallPost, FallMap, FallForce, FallLearn, FallAccount Trades, the AI Native Solutions hub — they all silently fail over to Ollama / Gemini / OpenRouter. Users see no outage. The estate self-defends.

License · sovereignty notice

MIT. Fork it, vendor-copy it, modify it. The 6KB shim is yours.

Built by AI Native Solutions. Part of the sovereign estate. Source on GitHub.

VIEW ON GITHUB THE FULL ESTATE
◊·κ=1   prime 379   v20.1 · φ=1.618 · κ=0.618   the cascade compounds