InternetSpeedTest-Py — Python Library & CLI for Fast, Private Internet Speed Testing

by jackson 3 months ago

WSL2 • xterm-256color • bash 154 views

🐍 InternetSpeedTest-Py — a fast, lightweight, and privacy-friendly Python library & CLI for testing your internet speed.
Built by InternetSpeedTest.net, this open-source tool lets you measure ping, download, and upload speeds right from your Python scripts or terminal — with zero tracking and 100% transparency.

🎥 In This Demo

This video demonstrates how to:

Install InternetSpeedTest-Py using pip
Run a quick speed test from the command line
Use the Python API to integrate speed testing in your own scripts
Export and analyze results with JSON or CSV

⚙️ Key Features

🚀 Fast & accurate download/upload measurements
🔒 Privacy-focused (no telemetry or tracking)
🧩 Python API + CLI included
🧰 JSON, CSV, and simple text output formats
🌍 Global test servers with smart auto-selection

💻 Quick Usage

# Install from PyPI
pip install internetspeedtest

# Run a simple test
internetspeedtest-py

# Get JSON output
internetspeedtest-py --json

Python API usage

from internetspeedtest import SpeedTest

st = SpeedTest()
results = st.run()
print(f"Ping: {results.ping} ms, Download: {results.download} Mbps, Upload: {results.upload} Mbps")

Learn More

Website: https://internetspeedtest.net
GitHub Repo: https://github.com/internetspeedtest-net/internetspeedtest-py
Docs & Blog: https://internetspeedtest.net/blog

More recordings by jackson

InternetSpeedTest CLI — Fast, Private & Open-Source Internet Speed Test for Your Terminal 0:49

by jackson 3 months ago

https://asciinema.org/a/749978

Copied!

Append ?t=30 to start the playback at 30s, ?t=3:20 to start the playback at 3m 20s.

See sharing docs for more link customization options.

Embed as image link

Use snippets below to display a preview image linking to this recording.
Ideal for places where scripts are not allowed, such as project README files.

HTML:

<a href="https://asciinema.org/a/749978" target="_blank"><img src="https://asciinema.org/a/749978.svg" /></a>

Copied!

Markdown:

[![asciicast](https://asciinema.org/a/749978.svg)](https://asciinema.org/a/749978)

Copied!

Embed the player

If you're embedding on your own page or on a site which permits script tags, you can use the full player widget:

<script src="https://asciinema.org/a/749978.js" id="asciicast-749978" async="true"></script>

Copied!

Paste the above script tag where you want the player to be displayed on your page.

See embedding docs for more player customization options.

You can download this recording in asciicast v2 format, as a .cast file.

Download

Replay in terminal

You can replay the downloaded recording in your terminal using the asciinema play command:

asciinema play 749978.cast

Copied!

If you don't have asciinema CLI installed then see installation instructions.

Use with stand-alone player on your website

Download asciinema player from the releases page (you only need .js and .css file), then use it like this:

<!DOCTYPE html>
<html>
<head>
  <link rel="stylesheet" type="text/css" href="/assets/asciinema-player.css" />
</head>
<body>
  <div id="player"></div>
  <script src="/assets/asciinema-player.min.js"></script>
  <script>
    AsciinemaPlayer.create(
      '/assets/749978.cast',
      document.getElementById('player'),
      { cols: 188, rows: 49 }
    );
  </script>
</body>
</html>

See asciinema player quick-start guide for full usage instructions.

While this site doesn't provide GIF conversion at the moment, you can still do it yourself with the help of asciinema GIF generator utility - agg.

Once you have it installed, generate a GIF with the following command:

agg https://asciinema.org/a/749978 demo.gif

Copied!

Or, if you already downloaded the recording file:

agg demo.cast demo.gif

Copied!

Check agg --help for all available options. You can change font family and size, select color theme, adjust speed and more.

See agg manual for full usage instructions.