Skip to main content
Gegentica is made up of a small set of cooperating services. The easiest way to see the whole system at once is the gegentic-quickstart Docker Compose bundle, which brings up every service together — this page describes the architecture defined there.

​
Services

​
Services diagram

​
Request flow

A governed LLM request moves through the stack like this: The Gateway sits in front of every AI call. It checks the Access Key against the API service, fetches the Agent’s Policy Set, and routes the request through Guardian both before the call leaves (input guardrails) and after the response comes back (output guardrails) before returning it. Every step along the way is recorded as a span in Tracing, which powers the audit log and review queue. The Portal is a separate flow — it’s the UI org owners use to configure Projects, Policy Sets, and Agents, and to browse traces. It talks to the API service directly and never sits on the request path.

​
Try it locally

The full architecture above is exactly what gegentic-quickstart starts with docker compose up. See Run Gegentica Locally with Quickstart for setup instructions.