Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Command line interface for testing internet bandwidth using
Python Groff
Latest commit 7b09d87 @sivel Bumping to 0.3.4



Command line interface for testing internet bandwidth using

Latest Version Downloads License


speedtest-cli works with Python 2.4-3.4



pip / easy_install

pip install speedtest-cli


easy_install speedtest-cli


pip install git+


git clone
python speedtest-cli/ install

Just download (Like the way it used to be)

wget -O speedtest-cli
chmod +x speedtest-cli


curl -Lo speedtest-cli
chmod +x speedtest-cli


$ speedtest-cli -h
usage: speedtest-cli [-h] [--bytes] [--share] [--simple] [--list]
                     [--server SERVER] [--mini MINI] [--source SOURCE]
                     [--timeout TIMEOUT] [--secure] [--version]

Command line interface for testing internet bandwidth using

optional arguments:
  -h, --help         show this help message and exit
  --bytes            Display values in bytes instead of bits. Does not affect
                     the image generated by --share
  --share            Generate and provide a URL to the share
                     results image
  --simple           Suppress verbose output, only show basic information
  --list             Display a list of servers sorted by
  --server SERVER    Specify a server ID to test against
  --mini MINI        URL of the Speedtest Mini server
  --source SOURCE    Source IP address to bind to
  --timeout TIMEOUT  HTTP timeout in seconds. Default 10
  --secure           Use HTTPS instead of HTTP when communicating with
            operated servers
  --version          Show the version number and exit


It is not a goal of this application to be a reliable latency reporting tool.

Latency reported by this tool should not be relied on as a value indicative of ICMP style latency. It is a relative value used for determining the lowest latency server for performing the actual speed test against.

There is the potential for this tool to report results inconsistent with There are several concepts to be aware of that factor into the potential inconsistency:

  1. has migrated to using pure socket tests instead of HTTP based tests
  2. This application is written in Python
  3. Different versions of Python will execute certain parts of the code faster than others
  4. CPU and Memory capacity and speed will play a large part in inconsistency between and even other machines on the same network

Issues relating to inconsistencies will be closed as wontfix and without additional reason or context.

Something went wrong with that request. Please try again.