liveplots

Real-time live plot server using ZeroMQ and Gnuplot.

Description

liveplots serves a minimalistic plotting API over ZeroMQ. Plot commands are sent fire-and-forget via PUSH/PULL sockets — the calling process is never blocked waiting for a response. Plots are generated by Gnuplot.

The purpose of this package is to monitor long-running computations without interfering with them (i.e. slowing them down).

Multiple plot servers can be started, each on its own daemon process.

Requirements

Python 3.12+
Gnuplot (install via apt install gnuplot on Debian/Ubuntu, brew install gnuplot on macOS)

Installation

uv add liveplots

Or with pip:

pip install liveplots

Quick Start

from numpy import random
from liveplots import PlotServer

pserver = PlotServer(port=0, persist=1)

data = random.normal(0, 1, 1000).tolist()
data2 = random.normal(4, 1, 1000).tolist()

pserver.lines([data, data2], [], ["data", "data2"], "Two plots")
pserver.flush_queue()

More examples in the examples/ directory.

Plot Gallery

Lines	Scatter	Histogram

Error Bars	Filled Curves	Boxplot

Heatmap	Multiplot

File System Monitor

The package also includes a cross-platform file system monitor based on watchdog:

from liveplots import Monitor

def action(fpath):
    print(f"File changed: {fpath}")

monitor = Monitor("/tmp", ["create", "modify"], action)

License

GPL-3.0-or-later

Metadata

Release files for liveplots 2.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for liveplots 2.0.1
File	Size	Uploaded	Provenance
liveplots-2.0.1.tar.gz	379.1 kB	Jun 22, 2026	With provenance	Details

Built distribution (wheel)

Table of built distributions (wheels) for liveplots 2.0.1
File	Interpreter	ABI	Platform	Reset
liveplots-2.0.1-py3-none-any.whl 13.5 kB Jun 22, 2026 With provenance	Python 3	none	any	Details

Total release size: 392.6 kB

Release files / liveplots-2.0.1.tar.gz

Download URL	liveplots-2.0.1.tar.gz
Size	379.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`45054ba0f586a7d5343975ab7796acd3678ca94bb5e433342e75ce0e356179f4`
BLAKE2b-256 checksum How to use checksums	`94085f151d72e5b19bccf4949a2660dc34e9637757a58be9ceeaa3d391c8ceea`
Upload date	Jun 22, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.12`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/fccoelho/liveplots
Publishing commit: github.com/fccoelho/liveplots/tree/035aff1425743ea16aca502b810553c162c16c48

Workflow

Publishing configuration: github.com/fccoelho/liveplots/blob/035aff1425743ea16aca502b810553c162c16c48/.github/workflows/publish.yml
Publishing logs: github.com/fccoelho/liveplots/actions/runs/27962998956/attempts/1

Artifact

Subject: liveplots-2.0.1.tar.gz
SHA-256 checksum: 45054ba0f586a7d5343975ab7796acd3678ca94bb5e433342e75ce0e356179f4 Verifying attestations

Release files / liveplots-2.0.1-py3-none-any.whl

Download URL	liveplots-2.0.1-py3-none-any.whl
Size	13.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`cdf66f9c50c920758d97dfb9acfa70f498940d24837268f8254b991a8718e09c`
BLAKE2b-256 checksum How to use checksums	`20b52b7298a7a4a53a9d929102915c4b08150c0260d70c4df635b11b2e369335`
Upload date	Jun 22, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.12`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/fccoelho/liveplots
Publishing commit: github.com/fccoelho/liveplots/tree/035aff1425743ea16aca502b810553c162c16c48

Workflow

Publishing configuration: github.com/fccoelho/liveplots/blob/035aff1425743ea16aca502b810553c162c16c48/.github/workflows/publish.yml
Publishing logs: github.com/fccoelho/liveplots/actions/runs/27962998956/attempts/1

Artifact

Subject: liveplots-2.0.1-py3-none-any.whl
SHA-256 checksum: cdf66f9c50c920758d97dfb9acfa70f498940d24837268f8254b991a8718e09c Verifying attestations

Security for liveplots 2.0.1

Report project as malware

Provenance

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Attestation for liveplots-2.0.1.tar.gz

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/fccoelho/liveplots
Publishing commit: github.com/fccoelho/liveplots/tree/035aff1425743ea16aca502b810553c162c16c48

Workflow

Publishing configuration: github.com/fccoelho/liveplots/blob/035aff1425743ea16aca502b810553c162c16c48/.github/workflows/publish.yml
Publishing logs: github.com/fccoelho/liveplots/actions/runs/27962998956/attempts/1

Artifact

Subject: liveplots-2.0.1.tar.gz
SHA-256 checksum: 45054ba0f586a7d5343975ab7796acd3678ca94bb5e433342e75ce0e356179f4 Verifying attestations

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.