plotsrv 0.4.0

Cheap observability for Python processes

    

Developer friendly, lightweight observability for Python processes.

Documentation · Quick start · Python API · CLI · Examples

Turn Python objects into live browser views with minimal code.

It is designed for scripts, pipelines, experiments, batch jobs, and long-running processes where useful outputs are otherwise hidden in terminal logs, temporary objects, generated files, or ad hoc plots.

plotsrv can render tables, plots, JSON, HTML, logs, images, tracebacks, files, and ordinary Python objects in a single browser UI.

Live demo: https://demo.plotsrv.com
See a deployed example showing real sensor data.

Install

pip install plotsrv

or:

uv add plotsrv

Quick example

import plotsrv as ps

summary = {
    "status": "ok",
    "rows_processed": 123,
    "checks": {
        "schema_valid": True,
        "duplicates": 2,
    },
}

ps.publish_view(
    summary,
    label="summary",
    section="demo",
    launch_server=True,
)

Open:

http://127.0.0.1:8000

Server workflow

For scripts, jobs, and pipelines, start plotsrv separately:

plotsrv run demo_pipeline.py --host 127.0.0.1 --port 8000

Then publish to it from Python:

import plotsrv as ps

@ps.view(label="daily import", section="pipelines", host="127.0.0.1", port=8000)
def daily_import_status():
    return {
        "job": "daily-import",
        "status": "ok",
        "rows_processed": 123,
    }

daily_import_status()

The function still returns normally, while plotsrv publishes the returned object into the browser UI.

What can plotsrv show?

plotsrv automatically chooses renderers for common outputs, including:

• pandas and Polars DataFrames
• matplotlib and plotnine plots
• dictionaries, lists, and JSON-like objects
• text, logs, markdown, HTML, and images
• Python objects and tracebacks
• files on disk, including CSV, JSON, YAML, TOML, markdown, HTML, text, and images

Why use it?

plotsrv provides cheap observability for Python processes.

It is useful when you want more visibility into a script or pipeline without building a dashboard, adopting a full observability stack, or manually opening generated files on disk.

Learn more

• What is plotsrv?
• Quick start
• Python API
• CLI reference
• Renderers
• Storage and history
• Deployment patterns
• Live demo

License

plotsrv is licensed under the Apache License 2.0.

See the LICENSE file for full details.