plotille

What it is and what it does

Plotille is a terminal-based plotting library that renders data visualizations using braille Unicode characters and ANSI colors. It offers two usage patterns: a high-level API with functions like plot(), scatter(), and histogram() for quick single-plot generation, and a Figure class for composing multiple plots with shared axes, legends, and custom styling. The library supports line plots with linear interpolation, scatter plots, histograms, heatmaps, image display, and basic timeseries plotting with datetime values.

With zero runtime dependencies and pure Python implementation, plotille integrates easily into CLI tools, monitoring dashboards, and data analysis scripts. It supports multiple color modes and works across Python 3.10, 3.11, 3.12, 3.13, and 3.14 on CPython and PyPy. The braille rendering provides finer granularity than ASCII art while remaining readable in any standard terminal.

Use it for:

• Quick visualization of numerical data in CLI scripts without leaving the terminal or opening a GUI window.
• Real-time monitoring dashboards that display metrics, trends, or system performance in a terminal interface.
• Educational demonstrations of mathematical functions, statistical distributions, or signal processing results.
• Exploratory data analysis in remote SSH sessions or containerized environments where graphical display is unavailable.
• Embedding plots in terminal-based reports or log output for inline data inspection.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Plotille renders plots, scatter plots, histograms, and heatmaps directly in the terminal using braille characters and colors, with no external dependencies.

Yes. Plotille is actively maintained, has zero dependencies, supports Python 3.10 through 3.14, carries no known vulnerabilities, and solves a genuine problem—rendering plots in terminals where graphical tools are overkill or unavailable. Install it if you need terminal visualization; skip it only if you require publication-quality graphics or 3D rendering.

Install

plotille on PyPI

pip install plotille

uv add plotille

poetry add plotille

Installing plotille

Before you install

Low friction: pure Python wheel with zero runtime dependencies. Actively maintained as of 2026-02-17 with 528 repository stars.

License in practice

MIT license permits unrestricted use, modification, and distribution in commercial and private projects.

Quickstart

pip install plotille

import plotille

X = [0, 1, 2, 3]
Y = [0, 1, 2, 3]
print(plotille.plot(X, Y, height=20, width=60))

Requires Python 3.10 or later; terminal must support Unicode braille characters for optimal rendering.

Verify before relying

• Whether timeseries plotting with datetime.datetime and numpy.datetime64 is production-ready or still experimental
• Performance characteristics when rendering large datasets or high-resolution terminal plots
• Extent of color mode support ('names', 'byte', 'rgb') across different terminal emulators

Package facts

Evidence: plotille-6.0.5-py3-none-any.whl

Keywords: plot, scatter, histogram, terminal, braille, unicode, timeseries

Tags

More Visualization packages