hax/fast-cli
1
0
Fork 0
mirror of https://github.com/mikkelam/fast-cli.git synced 2025-12-16 20:04:05 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
Command line version of fast.com in ~1.2 MiB
2 commits 2 branches 6 tags 168 KiB
Find a file
mikkelam 34ed84f50f refactor use of bandwidthmeter
2025-06-19 10:14:27 +02:00
.github/workflows Initial commit: Fast CLI - Blazing fast internet speed tester 2025-06-19 00:04:14 +02:00
src refactor use of bandwidthmeter 2025-06-19 10:14:27 +02:00
.gitignore Initial commit: Fast CLI - Blazing fast internet speed tester 2025-06-19 00:04:14 +02:00
build.zig Initial commit: Fast CLI - Blazing fast internet speed tester 2025-06-19 00:04:14 +02:00
build.zig.zon Initial commit: Fast CLI - Blazing fast internet speed tester 2025-06-19 00:04:14 +02:00
LICENSE Initial commit: Fast CLI - Blazing fast internet speed tester 2025-06-19 00:04:14 +02:00
README.md Initial commit: Fast CLI - Blazing fast internet speed tester 2025-06-19 00:04:14 +02:00

README.md

fast-cli-zig

Zig CI License: MIT

A blazingly fast CLI tool for testing internet speed compatible with fast.com (api v2). Written in Zig for maximum performance.

⚡ 1.3 MiB binary • 🚀 Zero runtime deps • 📊 Real-time progress

Why fast-cli-zig?

  • Tiny binary: Just 1.4 MiB, no runtime dependencies
  • Blazing fast: Concurrent connections with adaptive chunk sizing
  • Cross-platform: Single binary for Linux, macOS, Windows
  • Real-time feedback: Live speed updates during tests

Installation

Pre-built Binaries

For example, on an Apple Silicon Mac:

curl -L https://github.com/mikkelam/fast-cli-zig/releases/latest/download/fast-cli-aarch64-macos.tar.gz -o fast-cli.tar.gz
tar -xzf fast-cli.tar.gz
chmod +x fast-cli && sudo mv fast-cli /usr/local/bin/
fast-cli --help

Build from Source

git clone https://github.com/mikkelam/fast-cli-zig.git
cd fast-cli-zig
zig build --release=safe

Usage

❯ ./fast-cli --help
Estimate connection speed using fast.com
v0.0.1

Usage: fast-cli [options]

Flags:
     --stability-max-variance    Maximum variance percentage for stability test [String] (default: "10.0")
 -u, --upload                     Check upload speed as well [Bool] (default: false)
 -d, --duration                   Duration in seconds for each test phase - download, then upload if enabled (duration mode only) [Int] (default: 10)
     --stability-min-samples     Minimum samples for stability test [Int] (default: 5)
     --stability-max-duration    Maximum duration in seconds for stability test [Int] (default: 30)
     --https                     Use https when connecting to fast.com [Bool] (default: true)
 -j, --json                       Output results in JSON format [Bool] (default: false)
 -m, --mode                       Test mode: 'duration' or 'stability' [String] (default: "duration")
 -h, --help                       Shows the help for a command [Bool] (default: false)

Use "fast-cli --help" for more information.

Performance Comparison

TODO

Options

Flag Description Default
--upload, -u Test upload speed false
--duration, -d Test duration (seconds) 10
--json, -j JSON output false
--https Use HTTPS true

Example Output

$ fast-cli --upload
🏓 25ms | ⬇️ Download: 113.7 Mbps | ⬆️ Upload: 62.1 Mbps

Development

# Debug build
zig build

# Run tests
zig build test

# Release build
zig build --release=safe

License

MIT License - see LICENSE for details.

Not affiliated with Netflix or Fast.com