Termgraph is a command-line tool and Python library that draws basic graphs in the terminal.
The tool solves the problem of quickly visualizing data without leaving the command line or waiting for external graphing applications. It reads simple two-column text files with labels and numeric values, then renders them as terminal-based charts using block characters and ANSI color codes. The approach supports multiple graph types including bar charts, stacked charts, histograms, calendar heatmaps, and horizontal or vertical layouts, with the ability to customize tick marks and use emoji as visual elements.
Termgraph suits developers and system administrators who need fast, lightweight data visualization during command-line workflows or in environments where graphical output is impractical. It works well for quick exploratory analysis of small datasets stored in simple text formats. The tool is available both as a standalone command-line utility and as a Python library with classes for each chart type, making it flexible for scripting and integration into larger Python applications. The README does not compare it to alternative graphing tools.
The project maintains active code quality standards through automated linting with ruff and type checking with mypy, alongside comprehensive test coverage. Development follows a documented workflow with clear contribution guidelines, and the maintainers actively solicit bug reports, feature requests, and code contributions through GitHub Issues.
