AgenticX Enterprise Documentation

Enterprise is an integrated platform for enterprise LLM applications, combining employee portal (web-portal), admin console (admin-console), and AI gateway (gateway) with a shared Postgres multi-tenan

AgenticX Enterprise Documentation

Compiled from the full enterprise/ codebase. Last updated: 2026-05-21

Enterprise is an integrated platform for enterprise LLM applications, combining employee portal (web-portal), admin console (admin-console), and AI gateway (gateway) with a shared Postgres multi-tenant data layer and unified RBAC.

Quick navigation

I want to…	Go to
Run it for the first time	../README.md → development/local-dev.md
Understand the architecture	architecture/overview.md
Look up API routes	api/README.md
Look up database tables	database/schema.md
Look up environment variables	configuration/env-vars.md
Connect real models	development/local-dev.md#connect-real-models · gateway/runtime-config.md
Publish / test policies	gateway/policy-engine.md · api/admin-console.md#policy-rule-center
View token usage	api/admin-console.md#metering · `/metering` page
Key pool / PAT	gateway/keypool-pat-overview.md · gateway/api-tokens.md
MCP hosting	gateway/mcp-hosting-overview.md · runbooks/mcp-hosting.md
Configure SSO	runbooks/sso-oidc-setup.md
Configure policies / plugins	plugin-protocol/README.md · gateway/policy-engine.md
Deploy to Vercel + external Gateway	deployment/README.md
Customer customization	guides/enterprise-customers-collaboration.md
Troubleshooting	development/troubleshooting.md

Documentation index

Architecture

overview.md — Component topology, monorepo layout, tech stack
data-flow.md — Chat, policy, audit, and metering data flows
cache-and-pricing.md — L1/L2 cache and pricing normalization
mcp-hosting.md — In-gateway MCP Host
protocol-translation.md — OpenAI pivot translation
plugin-runtime.md — Rule-pack / tool-pack runtime

Apps & modules

apps/README.md — Four deployable units (portal / admin / gateway / edge-agent)
features/README.md — Ten business domains and implementation status
packages/README.md — Shared technical packages

API reference

api/README.md — API index
api/web-portal.md — Portal REST routes
api/admin-console.md — Admin REST routes
api/gateway.md — Go gateway OpenAI-compatible API
api/internal-api.md — Gateway ↔ Admin internal API

Gateway

gateway/overview.md — Routing, channel relay, quota, audit
gateway/policy-engine.md — Three-channel policy evaluation
gateway/runtime-config.md — Provider / quota / snapshot in Postgres
gateway/keypool-pat-overview.md — Key rotation, quota selection, PAT
gateway/api-tokens.md — Create and revoke agx-pat-
gateway/mcp-hosting-overview.md — MCP hosting overview

Data & permissions

database/schema.md — Drizzle schema, 22 tables, migration strategy
rbac/scopes.md — Scope registry and role templates

Configuration

configuration/env-vars.md — Full environment variable reference

Plugins

plugin-protocol/README.md — rule-pack / tool-pack / theme-pack manifest spec

Development & testing

development/local-dev.md — bootstrap / start-dev workflow
development/troubleshooting.md — Common issues
testing/README.md — E2E, visual tour, load-test scripts

Observability

observability/README.md — Prometheus /metrics and Grafana template

Deployment & operations

deployment/README.md — Docker self-host or Vercel + external gateway
deployment/local-selfhost.md
deployment/vercel-env-checklist.md
deployment/supabase-migration-guide.md
runbooks/ — SSO, audit backfill, policy rollback, PostgreSQL DDL lock waits, channel relay, MCP hosting, tunnel demos
perf-baselines/README.md — Archive hand-run k6 summaries; this repo has no historical baseline numbers

Architecture decisions

adr/0001-oss-foundations-selection.md

Acceptance & sales

Relationship to the desktop app

Dimension	Enterprise	Desktop (Near)
Backend	Go `apps/gateway` + Next.js API routes	Embedded Python `agx serve` (PyInstaller)
Model routing	Go OpenAI-compatible client	Python LiteLLM
Audience	Employee web workspace	Developer desktop agent
Policy engine	Go policy-engine (in gateway)	AgenticX Python framework + optional Go gateway

These are two separate lines. In customer write-ups, “on-device loop” means the desktop local backend — not apps/edge-agent (still a skeleton).

Maturity legend (used across these docs)

Mark	Meaning
✅ Shipped	Demoable locally, persisted in Postgres
🟡 Partial	Core path works; surroundings are stubbed
⚪ Stub	Placeholder package; logic lives elsewhere or is unbuilt
⛔ Skeleton	Design exists, code is not demoable