bozo

Production-grade structured logging for Python with an optional real-time web viewer.

Why I built it

Every Python service I started ended up reinventing the same logging stack — console formatting, file rotation, JSON output for aggregation, and ad-hoc context propagation. bozo is the one-call setup that gets all of it right by default, so projects can ship with proper observability from day one instead of bolting it on later.

What makes it interesting

One bozo.setup() wires up colored console output, rotating text files, structured JSON, HTTP shipping, and (optionally) a real-time web dashboard — simultaneously. Sensitive values are redacted via bozo.redact(...). bozo.log_context(...) attaches request/job metadata that survives async hops and threads. Old runs are archived and pruned automatically. Fully type-safe on Python 3.13+.

Tech Stack

Python 3.13+ · structlog-style structured records · Async / threaded context propagation · File rotation & archival · Optional FastAPI-based real-time web viewer · MIT licensed