IBEX Harness
DocsBenchmarksBlogChangelogRoadmap
GitHub
IBEX Harness

Documentation

Documentation

Product docs for the IBEX Harness auth service, LLM proxy, and operator surfaces that ship today.

IBEX Harness is a self-hosted AI agent platform: an authenticated LLM proxy, multi-tenant identity service, and (in later phases) persistent agent memory. These docs describe what ships on main today.

Live program status: current state. Design rationale lives in ADRs.

Capability boundary

Shipped: Auth (Go), Proxy (Go), shared runtime packages (auth cache, directives, sessions, idempotency, ClickHouse traces), and this public site. Planned (Phase 3+): Python memory, context assembly, worker, API, and dashboard — do not treat those as implemented.

Start here

Quickstart

Tutorial

Boot compose-dev and send a chat completion in mock mode.

Learn more →

Concepts

Guide

Tenancy, PATs, proxy critical path, and phase honesty.

Learn more →

Architecture overview

Guide

Services, data stores, and request flow.

Learn more →

Chat completions API

Reference

HTTP shape, errors, and streaming notes.

Learn more →

HTTP route inventory

Reference

Public and protected proxy paths as implemented.

Learn more →

Integrate the proxy

Proxy overview

Guide

Middleware chain from auth to provider forward.

Learn more →

Authentication

Guide

PATs, agent verify, cache, and revocation.

Learn more →

Provider modes

Guide

Mock vs live OpenAI-compatible forwarding.

Learn more →

Issuing API keys

Guide

Create and revoke org-scoped PATs.

Learn more →

Platform features (Phase 2)

These Phase 2 surfaces are implemented. Use the guides below for configuration and failure modes.

Directives

Guide

Org directives and system-prompt injection.

Learn more →

Sessions

Guide

Session lifecycle and checkpoints.

Learn more →

Auth cache

Guide

Bloom + LRU cache with revocation.

Learn more →

Traces & ClickHouse

Guide

Async LLM trace writes.

Learn more →

Operate and harden

Observability

Guide

Metrics, logs, and OpenTelemetry.

Learn more →

Environment variables

Reference

Runtime configuration registry.

Learn more →

Security overview

Guide

Fail-closed auth and tenant isolation.

Learn more →

Troubleshooting

Guide

Common local and production failures.

Learn more →

Was this page helpful?

Edit on GitHub

Last updated on

On this page

  • Start here
  • Integrate the proxy
  • Platform features (Phase 2)
  • Operate and harden
0%