fabricatio-webui 0.3.0

An extension of fabricatio

fabricatio-webui

MIT

Web UI service for the Fabricatio LLM application framework. Serves a Vue-based single-page application built with Vite over an axum HTTP server (Rust, bound via PyO3).

---

Installation

pip install fabricatio[webui]
# or
pip install fabricatio-webui

The CLI entry point requires the cli extra:

pip install fabricatio-webui[cli]

Quick Start

Start the service with the bundled frontend:

fc-webui

This serves the SPA at http://127.0.0.1:9846. Use --frontend-dir / -d to point at a custom build, and --addr / -a to change the bind address:

fc-webui --addr 0.0.0.0:3000 --frontend-dir ./dist

API

All functionality is exposed through the Rust-backed Python module fabricatio_webui.rust.

start_service(frontend_dir, addr)

Starts an async HTTP server (axum + tokio) that serves static files from frontend_dir with SPA fallback (all unmatched routes serve index.html). CORS is permissive.

Parameter	Type	Description
frontend_dir	str | PathLike	Directory containing the built frontend
addr	str	Bind address, e.g. "127.0.0.1:9846"

import asyncio
from fabricatio_webui.rust import start_service

asyncio.run(start_service("./www", "127.0.0.1:9846"))

Configuration

WebuiConfig is a frozen dataclass loaded from Fabricatio's configuration system:

from fabricatio_webui.config import webui_config

Dependencies

• fabricatio-core — core interfaces and configuration
• axum + tokio + tower-http (Rust) — HTTP server and middleware
• typer (optional, for CLI) — fc-webui command

License

This project is licensed under the MIT License.