Skip to content

Serve

txi serve launches a local web dashboard for browsing and reading indexed transcripts.

Install the web extra first:

uv sync --extra web

Then sync the corpus and start the server:

txi sync
txi serve

By default the dashboard listens on http://127.0.0.1:8765. It is intended for local use only and does not provide authentication.

Options

txi serve --host 127.0.0.1 --port 9000
txi serve --reload
  • --host — host interface to bind. Defaults to [server].host.
  • --port — port to bind. Defaults to [server].port.
  • --reload — restart on code changes during development.
  • --config PATH — load an alternate config file.

Dashboard

The dashboard shows conversations in the sidebar and the selected transcript in a scrollable chat-style reader. It follows the system light/dark appearance. Sidebar search supports browse, FTS, semantic, and hybrid modes using the same search helpers as the CLI.

Semantic and hybrid search require the same embedding provider dependencies and API keys as txi search semantic and txi search hybrid.

The top navbar exposes Browse and Analytics. The Analytics page surfaces activity, top speakers, length distribution, an embedding map, and a data-quality panel for the current corpus.

Conversation URLs are deep-linkable:

/conversations/142
/conversations/142?turn=8