Explorer docs
docsuai-explorerredacted view

UAPI Explorer (Python Catalog at CT121)

UAPI Explorer is the AI-first documentation and context catalog for UAI

Updated 2026-06-25·Freshness: Reference·No secret-like patterns were observed in this view.

UAPI Explorer (Python Catalog at CT121)

UAPI Explorer is the AI-first documentation and context catalog for UAI

Body

UAPI Explorer (Python Catalog at CT121)

Purpose

UAPI Explorer is the AI-first documentation and context catalog for UAI project material. It is the surface you are most likely interacting with right now: it serves the /ready, /api/ai/bootstrap, /api/ai/context/{slug}, /api/ai/catalog, and (as of v0.3.0) /api/ai/documents AI-lane endpoints. The product is Python/FastAPI, the catalog is curated (not raw-filesystem-traversed), and every AI packet goes through server-side redaction with an audit-event ID.

This is a standalone product, distinct from the sibling Rust UAI Explorer at 100.119.16.109:18080. The two are easy to conflate; see uai-doc-... for the split.

Current State

  • Status: active, governed internal production.
  • Production host: CT121 (10.0.0.121:8080).
  • Sandbox host: CT126 (10.0.0.126:8080).
  • Production version: 0.2.3 (public-safe mode).
  • Sprint in flight: v0.3.0 — AI-authoring surface (POST /api/ai/documents, PATCH /api/ai/documents/{slug}, GET /api/ai/capabilities). Branch feature/ai-authoring-v0.3.0.
  • Catalog size: 184 AI-visible entries as of 2026-06-25.
  • Readiness flags: public_safe_mode=true, redaction_boundary=server-side, admin_raw_downloads_enabled=false, legacy_file_apis_enabled=false, uploads_enabled=false, raw_survey_zone_mounted=false.

Key Components / Locations

  • Source tree: uai-explorer repo on Beacon (this working directory).
  • Server entrypoint: server.py.
  • Curated catalog data: DATA_ROOT (default /opt/uai-explorer/data).
  • SQLite DB: EXPLORER_DB (default /opt/uai-explorer/uai-explorer.sqlite3).
  • Deploy scripts: deploy.sh (production CT121), deploy-sandbox.sh (sandbox CT126 — refuses to run against CT121).
  • Service unit: uai-explorer.service.
  • Docs surface: docs/runbooks/, docs/plans/, docs/evidence/, docs/qa/, docs/diary/.

Relationships

  • Sibling product: uai-doc-... (Rust catalog at Beacon mesh — different codebase, different scope).
  • Deploys on: uai-doc-ecosystem-hardware-ct121 (production), uai-doc-ecosystem-hardware-ct126 (sandbox).
  • Consumed by: all AI agents running in the UAI lab per the agent guide (/api/ai/bootstrap then /api/ai/context/{slug}).
  • Sprint: uai-doc-....

Status

active — governed internal production; v0.3.0 AI-authoring sprint in flight.

See Also

  • uai-doc-...
  • uai-doc-ecosystem-hardware-ct121
  • uai-doc-ecosystem-hardware-ct126
  • uai-doc-...
  • uai-doc-start_here_ai
  • uai-doc-uai_explorer_rules