Fast-CLI Premium 🚀

A premium CLI & interactive web dashboard for real-time internet speed analytics, powered by fast.com.

Experience sleek, real-time analytics with the new Premium Web Dashboard.

---

✨ Features

• ⚡ High Accuracy: Powered by Netflix's Fast.com infrastructure.
• 🎨 Premium UI: Experience a sleek Discord-inspired interactive web dashboard.
• 📊 Real-time Metrics: Track Download, Upload, Latency, and Data Transferred.
• 🛠️ Professional Toolkit: JSON output, Verbose metadata, and timeout controls.
• 🛡️ Fail-Safe: Built-in watchdog for stuck tests and automatic retry mechanism.

---

📦 Install

Ensure you have Node.js 20+ installed.

npm install --global fast-cli

Note: This project uses Puppeteer. If you encounter issues, please check the troubleshooting guide.

---

🚀 Usage

🖥️ CLI Quick Start

Run the basic speed test directly in your terminal:

fast

🌐 Premium Dashboard (GUI)

Launch the interactive web-based dashboard:

fast --gui

⏱️ Timed Test

Get a reading in a specific amount of time (e.g., 10 seconds):

fast --timeout 10

---

⚙️ Commands & Options

Command	Description
fast	Standard terminal test (Download only).
--gui	Opens the premium browser-based dashboard.
--upload, -u	Include Upload speed in terminal measurement.
--verbose	Show detailed latency, IP, and server info.
--timeout, -t	Set a max runtime for the test in seconds.
--json	Output machine-readable JSON data.
--single-line	Compact output for automation/scripts.

---

📖 Examples

Professional Metadata

Get a deep-dive into your connection health:

fast --verbose

72 Mbps
8 Mbps

Latency: 8 ms (unloaded) / 16 ms (loaded)
Client: San Francisco, CA • 1.1.1.1

Machine Readable (JSON)

Perfect for logs or custom dashboards:

fast --upload --json

{
  "downloadSpeed": 970,
  "uploadSpeed": 450,
  "downloadUnit": "Mbps",
  "uploadUnit": "Mbps",
  "downloaded": 810,
  "uploaded": 420,
  "latency": 1,
  "userLocation": "San Francisco, CA",
  "userIp": "1.1.1.1"
}

---

🛠️ Related

• speed-test - Speedtest.net powered CLI.

---

Developed with ❤️ for the community.