Welcome to Geodesia G-1¶
Geodesia G-1 is a validating gateway that sits in front of any large language model (LLM) and provides a comprehensive quality and compliance layer. It is fully OpenAI-compatible β your existing application sends requests to Geodesia G-1 exactly as it would to OpenAI, and the gateway forwards them to your chosen underlying model (vLLM, Ollama, SGLang, OpenAI, TensorRT-LLM, and others) after enriching both the input and output with safety and reliability signals.
The platform is now Application-oriented β with G-1 Studio, one shared LLM and GLAD-Hummingbird detector can serve many isolated Applications, each with its own policy, thresholds, RAG collection, compliance posture, and cost center.
You do not need to retrain your model. You do not need to change your application code. You plug Geodesia G-1 in, and your LLM immediately gains:
- Hallucination detection β five independent signals that tell you whether the model's answer is grounded in the provided context or is a fabrication.
- Safety enforcement β real-time prompt screening and answer inspection to block unsafe, harmful, or jailbreak requests before they reach the model or the user.
- Regulatory compliance β a full audit trail, EU AI Act impact assessments, GDPR data retention, kill-switch, human oversight escalation, and more β across 13 global frameworks.
- Causal explainability β token-level attribution that shows exactly which words in the input caused the model's output, with no access to model internals required β painted as a heatmap on the text.
- Realtime voice guard β a streaming-Whisper layer in front of the detector screens spoken jailbreaks and unsafe prompts as they are said, and brakes mid-sentence.
- MCP security β starting the proxy starts an MCP security layer that vets every tool description, tool-call argument and tool result before an agent can act.
Any LLM, Any Provider
Works with vLLM, SGLang, TensorRT-LLM, Ollama, OpenAI, and any OpenAI-compatible endpoint. Switch backends from the UI without restarting.
6-Axis Detection
GLAD-Hummingbird scores context faithfulness, closed-book fabrication, prompt safety, answer safety, jailbreak, and rag_jailbreak (RAG / context-injection firewall) β each scored independently with calibrated thresholds.
Realtime Voice Guard
A streaming Whisper layer (sliding window Β· LocalAgreement-2) transcribes speech incrementally and re-scores it on the input axes β a brake on the microphone that stops spoken jailbreaks mid-sentence. tiny baked in, real-time on CPU.
MCP Security Layer
Starting G1-Proxy starts an MCP security gateway: GLAD vets every tool description, tool-call argument and tool result β stopping tool poisoning, rug-pulls, indirect injection and exfiltration before an agent acts.
Causal Explainability
Black-box token-level attribution painted as a heatmap on the answer β MuPAX / SHAP over the detector, no upstream-model internals. Shows the one token that caused the flag.
Deep Scan (GLAD-Tapestry)
Opt-in geometric MoE second opinion for high-stakes Applications β blended confidently into the safety and hallucination axes. Off by default; zero overhead until enabled.
Knowledge Base / RAG
Upload PDFs, Word documents, slides, and more. Geodesia retrieves relevant passages and verifies claim-by-claim that the answer stays within the documents.
G-1 Studio
Multi-Application platform β one LLM + GLAD-Hummingbird serves many isolated Applications, each with its own policy, thresholds, RAG, compliance posture, and cost center / FinOps budget.
13 Regulatory Frameworks
EU AI Act, GDPR, ISO 42001, NIST AI RMF, California SB 942, Italy Law 132/2025, Canada AIDA, Brazil 2338, UK DUAA 2025, China GB 45654, and more.
Live Compliance Dashboard
Real-time bar charts of passed, blocked, hallucinated, and unsafe calls. FRIA dossier generation for the EU AI Act. Deployer transparency manual in one click.
Cryptographic Audit Chain
Every inference is hashed and chained (Merkle-style) into an append-only ledger. Run a single API call to prove no record has been tampered with.
How It Works¶
Every request flows through input validation β the LLM you choose β output validation, with each call written to the compliance ledger.
Every chat message goes through this pipeline:
- Input validation β the prompt and conversation history are scored across prompt safety and jailbreak detection axes. If a threshold is exceeded in blocking mode, the request is refused before the model sees it. Spoken input is transcribed by a streaming Whisper layer and scored on the same axes, mid-utterance.
- Context injection β if you supplied a grounding context (or uploaded documents to the knowledge base), it is injected into the upstream request.
- Generation β the upstream LLM produces a response. For streaming requests, Geodesia monitors every 32 tokens (configurable cadence) and can halt generation mid-stream if dangerous content emerges.
- Output validation β the completed answer is scored for hallucination and unsafe content. RAG answers additionally go through claim-level citation verification.
- Compliance logging β the call is written to the audit database, watermarked, and linked to the running hash chain.
- Response delivery β the original OpenAI-compatible response is returned with an additional
geodesiafield containing the full detection payload.
Quick Navigation¶
| I want to⦠| Go to⦠|
|---|---|
| Install Geodesia G-1 (one command) | Installer (install.sh) |
| Configure & operate the stack | Installation & Configuration |
| Create an API key & make my first call | Developer Quickstart |
| Connect my first LLM backend | Upstream Backends |
| Understand the detection axes | Detection Axes |
| Guard realtime voice input | Audio Input (Realtime Voice) |
| See how explainability works | Causal XAI β visualized |
| Secure MCP tools & agents | MCP Security Gateway |
| Set up multiple Applications | G-1 Studio |
| Track cost & budgets | Cost & FinOps |
| Call the chat endpoint | Chat API |
| Upload documents for RAG | Knowledge Base |
| Set up compliance for the EU AI Act | FRIA |
| Configure detection thresholds | Detection Thresholds |
| See all environment variables | Environment Variables |
| Understand the response format | API Response Format |
| Run the system | Quick Start |