speedtest-cli

Installation

I strongly recommend to use pipx or uv to install this tool. These tools will install the package in an isolated environment and will not interfere with your system packages.

Using pipx

pipx install speedtest-cloudflare-cli

Using uv

uv tool install speedtest-cloudflare-cli

Using pip

Warning

It is not recommended to install this package using pip. It will install the package in your system packages and may interfere with other packages.

pip install speedtest-cloudflare-cli

Features

• ⏱️ Time-Based Testing - 10 second default timeout per test for consistent, fast results
• 🚀 Adaptive Test Sizing - Automatically adjusts test size based on your connection speed
• 📊 Comprehensive Metrics - Download/upload speed, ping, jitter, and HTTP latency
• 🌍 Cloudflare Infrastructure - Tests using Cloudflare's global network
• 🎨 Beautiful Output - Rich terminal interface with progress bars and tables
• 📄 Multiple Output Formats - Console, JSON, and interactive web dashboard
• 🔒 Privacy Focused - No tracking, no accounts, open source

Usage

Run the following command to test your internet speed.

speedtest-cli

By default, each test (download/upload) runs for 10 seconds and calculates speed based on data transferred. You can customize the timeout:

# 5 second timeout per test
speedtest-cli --timeout 5

# 20 second timeout for more accuracy
speedtest-cli --timeout 20

For more information, run the --help command.

speedtest-cli --help

Running in a container

Using Podman

podman run --rm -it ghcr.io/takitsu21/speedtest:latest

Using Docker

docker run --rm -it ghcr.io/takitsu21/speedtest:latest