# httpstat

> Visualizes curl statistics with timing breakdowns of DNS, TCP, TLS, server processing, and content transfer.

Stars: 6.2k · Language: Python · License: MIT · Categories: Network

- Repository: https://github.com/reorx/httpstat
- Page: https://www.trmn.sh/tools/httpstat

## Install

- Homebrew: `brew install httpstat`
- pip: `pip install httpstat`
- Direct download: `wget https://raw.githubusercontent.com/reorx/httpstat/master/httpstat.py`

## Overview

httpstat is a Python wrapper around curl that provides detailed timing visualization for HTTP requests. It displays a breakdown of connection phases including DNS resolution, TCP connection, TLS handshake, server processing time, and content transfer in a color-coded terminal output.

The tool offers structured JSON output with a stable v1 schema for programmatic consumption, making it suitable for monitoring and automation workflows. It includes SLO threshold checking that exits with code 4 when response times exceed specified limits for metrics like total time, connection time, or time to first byte. Results can be saved to files for multi-step workflows.

As a single-file Python script with no dependencies, httpstat is easy to deploy and works with Python 3. It accepts any curl options and supports environment variables for customizing behavior. The tool includes an agent skill for AI coding assistants to automatically diagnose HTTP performance issues and suggest fixes. It's primarily used by developers, DevOps engineers, and SREs for debugging API latency and HTTP performance analysis.

### Installation

```bash
# via Homebrew
brew install httpstat
```

```bash
# via pip
pip install httpstat
```

```bash
# via Direct download
wget https://raw.githubusercontent.com/reorx/httpstat/master/httpstat.py
```

![httpstat terminal output](https://media.trmn.sh/cached/4e091cf7f3390cf8879d744ef419bb87b20eccd0d6d13c88ca2c41d6f2943f30.png)

## Alternatives

- [BBOT](https://www.trmn.sh/tools/bbot.md): Recursive internet scanner for recon, bug bounties and ASM: subdomain enumeration, web spidering, email gathering and web scanning via presets. (Python, 10.9k stars)
- [Streamlink](https://www.trmn.sh/tools/streamlink.md): Python CLI and library that pipes video streams from services like Twitch and YouTube into a video player such as VLC, or writes them to disk. (Python, 11.9k stars)
- [posting](https://www.trmn.sh/tools/posting.md): Terminal-based HTTP client with keyboard navigation, local YAML storage, and syntax highlighting (Python, 12.6k stars)
- [sshuttle](https://www.trmn.sh/tools/sshuttle.md): Transparent proxy that tunnels traffic to a remote network over ssh, acting as a VPN substitute without requiring admin access on the remote side. (Python, 13.6k stars)
- [gallery-dl](https://www.trmn.sh/tools/gallery-dl.md): Cross-platform command-line program that downloads image galleries and collections from many image hosting sites, with configurable file naming. (Python, 20.3k stars)

---

Canonical: https://www.trmn.sh/tools/httpstat