README.md

metadata

title: Citadel Explorer
emoji: 🏰
colorFrom: gray
colorTo: blue
sdk: gradio
sdk_version: 5.29.0
app_file: app.py
pinned: false
license: mit

Citadel -- AI Operations Platform

Interactive explorer for the Citadel AI operations platform.

Citadel is a production-grade, 6-package AI infrastructure toolkit built from first principles in Python. No vendor lock-in, no opaque abstractions -- every component is transparent, testable, and swappable.

Architecture

citadel-core        Shared types, configuration, error hierarchy
citadel-gateway     LLM gateway with multi-provider routing, caching, circuit breakers
citadel-vectordb    HNSW vector search engine built from scratch (no FAISS/Annoy)
citadel-agents      ReAct agent runtime with tool registration and execution
citadel-ingest      Document ingestion pipeline (PDF, HTML, plaintext, chunking)
citadel-observe     Observability layer -- cost tracking, latency histograms, dashboards

What This Demo Shows

Tab	Description
LLM Gateway	Interactive routing simulation -- enter a prompt, see which provider gets selected and why (complexity scoring, regex rules, keyword matching)
HNSW Vector Search	Live nearest-neighbor search over a built-in 50-sentence dataset using cosine similarity, with 2D vector space visualization
Agent Runtime	Step-through ReAct agent reasoning loop showing Thought / Action / Observation / Final Answer chains
Observability	Realistic dashboard with request rates, latency distributions, token usage, cost breakdown by provider

All demos run client-side with mock data -- no API keys or external services required.

Links

• Source code: github.com/dbhavery/citadel
• Author: Don Havery