> ## Documentation Index
> Fetch the complete documentation index at: https://developers.agentx.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Self-Host Overview

> The full Trace, Monitor, Evaluate, and Improve stack on your own machine - no account, bring your own LLM keys

[AgentX-trace-eval](https://github.com/AgentX-ai/AgentX-Trace-Eval) is the open-source,
self-hosted build of AgentX's governance layer. One local install gives you the complete loop -
**Trace**, **Monitor**, **Evaluate**, **Improve** - with no account and no multi-tenant billing.
You bring your own OpenAI, Anthropic, or Gemini keys for the LLM-judge features; everything else
runs entirely offline.

## Architecture

* **Engine** - a TypeScript HTTP API (the same Trace/Monitor/Evaluate logic the hosted product
  runs) compiled to a single native binary, so no Node or Bun is needed at runtime. SQLite by
  default, Postgres via one connection string.
* **CLI** (`agentx` / `agentx-server`) - a small Go launcher: starts the engine, opens the
  dashboard, forwards shutdown signals.
* **Dashboard** - the real AgentX Governance UI, not a rebuild: the same frontend the hosted
  product uses, built in self-host mode and served by the engine itself.

Get running in a minute with [Installation](/self-host/installation), then tune
[Configuration](/self-host/configuration) as needed. Every feature page in the Trace, Monitor,
Evaluation, and Improve tabs applies to a self-hosted instance; pages marked "Self-host
feature" are exclusive to it.

## What's included

**Observe** - Live Traces with span-tree Timeline/Graph views and trajectory metrics,
[Sessions](/trace/sessions) with conversation-level judging, per-framework tracing guides in
the UI.

**Monitor** - built-in and custom [patterns](/monitor/patterns),
[online evaluators](/monitor/online-evaluators) (per-trace and per-session),
[custom evaluators](/monitor/custom-evaluators), [topics](/monitor/topics), signal triage with
archiving, [outcomes and judge calibration](/monitor/outcomes),
[model comparison](/monitor/model-comparison).

**Evaluate** - datasets with [version history](/evaluation/version-history),
[code scorers](/evaluation/code-scorers), evaluator configs, runs with judge scores and
trajectory matching, [datasets curated from production](/evaluation/datasets-from-production),
[model portability](/evaluation/model-portability), and the interactive
[Playground](/evaluation/playground) with conversation simulation.

**Improve** - [Prompt Management](/improve/prompt-management) and
[Tools](/improve/tool-schemas) registries with evidence-backed suggestions and
[measured proposal validation](/improve/validating-proposals), plus
[CI gates](/sdk/ci-cd) with recorded history.

<Note>
  Features that call an LLM - judge scoring, online evaluators, semantic
  patterns, suggestion drafting, Playground runs - need a provider key
  (`OPENAI_API_KEY` / `ANTHROPIC_API_KEY` / `GEMINI_API_KEY`), settable via
  environment or the dashboard's Platform Settings. Trace ingest, phrase/regex
  patterns, and code scorers run with no keys at all.
</Note>

## What stays hosted-only

Hosted's native autotune workflow (candidate config branching for AgentX-built agents) is tied
to the hosted agent-builder and is an explicit non-goal for self-host - the Improve tab here
centers on the prompt/tool registries instead, which serve the same "make the agent better"
purpose for externally-built agents.

## Open source scope

The engine, CLI, and Python SDK are Apache-2.0. The dashboard is built from AgentX's private
frontend; only its **compiled bundle** is published, attached to
[the repo's releases](https://github.com/AgentX-ai/AgentX-Trace-Eval/releases) - so installs
and source builds never need access to the private repo, and dev mode fetches the bundle
automatically on first boot.

<CardGroup cols={2}>
  <Card title="Installation" icon="download" href="/self-host/installation">
    curl | bash, pip, Docker, or from source
  </Card>

  <Card title="Configuration" icon="gear" href="/self-host/configuration">
    Ports, Postgres, auth mode, provider keys
  </Card>

  <Card title="Tracing" icon="radar" href="/sdk/tracing">
    What gets recorded on every traced call
  </Card>

  <Card title="GitHub" icon="github" href="https://github.com/AgentX-ai/AgentX-Trace-Eval">
    Source, issues, and the full README
  </Card>
</CardGroup>