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 G1-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 β independent, separately calibrated 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.
- Token & cost control β off-topic requests are refused before the upstream call (zero tokens billed) and easy prompts are routed to a cheaper model than hard ones, from the same detector pass.
- A security policy that evolves with you β Policy Lens simulates a threshold change on your own real traffic before you apply it, and every human correction feeds back into the detector.
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 Guardrail Axes + 3 Signals
G1-Hummingbird scores six primary guardrail axes β context faithfulness, closed-book fabrication, prompt safety, answer safety, jailbreak and rag_jailbreak (context-injection firewall) β plus three additional signals that annotate but never block: profanity, out-of-scope and prompt complexity. Independent axes, calibrated thresholds, one forward pass.
Token & Cost Control
Two additional signals that pay for themselves: out_of_scope can refuse off-topic traffic before the upstream call (zero tokens billed) once you enable it on an Application, and prompt_complexity routes easy prompts to the cheap model and hard ones to the capable one β no extra latency, no extra model call.
Policy Lens
Security is relative to your policy. Simulate a threshold change against your own real traffic β exactly which requests would flip, and which flips your reviewers already confirmed β then apply it with one click and a hot reload.
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: G1-Hummingbird 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
Deterministic token-level attribution painted as a heatmap on the answer β DCA and MuPAX LLM over the detector, no upstream-model internals, no gradients, no sampling. Shows the one token that caused the flag, and proves it by removing it.
Thinking Levels
A per-request dial β thinking_level 0β3 β that buys a stricter verdict on borderline or high-stakes turns, up to MAX at level 3. Off by default; zero overhead until requested.
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 + G1-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 |
| Cut my token bill | Token & Cost Control |
| Tune a threshold on my own traffic | Policy Lens |
| 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 |
| See every G1-Proxy endpoint | G1-Proxy API Map |
| See every G-1 Studio endpoint | Studio API Map |
| Find the API behind a Studio UI control | UI Component Reference |
| 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 |