Auracle/Docs/Web UI

Web UI

The visual front-end at http://localhost:1969/. In v1.0 the Auracle Agent is driven through the API; the surfaces below cover what ships today.

Overview

Houston is a server-rendered FastAPI + Jinja2 application with HTMX for in-place updates. No SPA, no client-side router. Pages are full HTML responses; interactivity is layered on top via small HTMX fragments. This keeps the bundle tiny and the surface scriptable.

Auracle Agent (API-only in v1.0)

v1.0 status In v1.0 the Auracle Agent surface is API-only. The dedicated web UI (Discover / Catalog browser / Research flow / Candidates pages) is on the v1.1 roadmap. For now, drive the Auracle Agent through the REST API or the auracle forge CLI subcommands.

The active Auracle Agent surface today:

Action	API	CLI equivalent
List configured providers	`GET /forge/providers`	`auracle forge providers`
Browse the catalog	`GET /forge/catalog` (filter via `?verdict=&provider=&asset_class=`)	`auracle forge catalog`
Inspect one dataset	`GET /forge/catalog/{id}`	`auracle forge dataset <id>`
Get the ambient context the AI assistant uses	`GET /forge/ambient`	`auracle forge ambient`

The full schema for each endpoint is in the OpenAPI docs at https://<your-host>/api/docs. The Auracle Agent concept doc walks through the agents, scoring rubric, and cost model.

Pin / exclude / promote actions and the full Discovery / Probe / Planner / Synthesis pipeline UI land in v1.1. v1.0 ships the catalog, ambient context, and per-dataset inspection only.