Parked foundation — outside the released Windows suite. This repository contains exploratory/support code, not a completed Townlight product. It is not installed or supported by Windows 1.8.1.1. Historical examples, package names and dependency pins below describe this foundation and must not be used as current suite installation instructions. Use the released Windows suite, current modules and acceptance limits.
Townlight Utilities v0.1.1 ships the utility customer-service copilot foundation for Townlight: cited utility-policy Q&A, CSR-safe read-only account context, payment-arrangement draft support, service-request intake, optional database-backed account/service workpapers, FastAPI runtime, public sample UI, docs, tests, browser QA, and release gates.
It is not a utility billing system, payment processor, rate engine, shutoff/reconnect workflow, system of record, live LLM runtime, live billing connector, or Townlight 311 write-back integration.
Install:
python -m pip install -e ".[dev]"
python -m uvicorn civicutility.main:app --host 127.0.0.1 --port 8142Townlight Utilities v0.1.1 is pinned to civiccore==0.3.0.
Optional workpaper persistence is available with CIVICUTILITY_WORKPAPER_DB_URL. Set it to a SQLAlchemy database URL to store CSR-safe account snapshots and service-request intake drafts for later review. If unset, POST endpoints remain stateless and retrieval endpoints return an actionable setup message.
Code: AGPL-3.0-only, with the TownLight Public Institution Exception for qualifying deployments. See LICENSE and LICENSE-EXCEPTION.md. Documentation: CC BY 4.0 (LICENSE-DOCS).