Skip to content

fezcode/atlas.bench

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

11 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Atlas Bench

Banner Image

Important

atlas.bench is part of the Atlas Suiteโ€”a collection of high-visibility, local-first terminal utilities designed for power users who demand precision and aesthetic clarity.

atlas.bench is a professional-grade, multi-command benchmarking tool that brings statistical rigor to the terminal. Whether you are comparing two different languages, optimizing a hot loop in your code, or auditing system performance, Atlas Bench provides the data you need in a beautiful, synchronized TUI dashboard.

Go Version Build System Platform

โœจ Key Features

  • ๐ŸŽ๏ธ Side-by-Side Comparison: Instantly see which command is the "Winner" with high-contrast TUI indicators.
  • ๐Ÿ”ฌ Statistical Rigor: Calculates Mean, Median, Min/Max, and Standard Deviation to filter out noise.
  • ๐Ÿ”ฅ Intelligent Warm-up: Automatically performs unmeasured "warm-up" runs to ensure disk caches and OS scheduling are primed.
  • ๐Ÿ“Š Stability Metrics: Standard Deviation tracking helps you identify "jittery" processes that are fast but inconsistent.
  • ๐ŸŽจ High-Visibility TUI: Built with the Atlas "Onyx & Gold" aesthetic for maximum readability in any terminal environment.
  • ๐Ÿ“ฆ Zero Dependencies: Compiles to a single, static binary for zero-friction deployment.

๐Ÿš€ Installation

Using Gobake (Recommended)

This project uses the Atlas gobake orchestration tool for cross-platform builds.

git clone https://github.com/fezcode/atlas.bench
cd atlas.bench
gobake build

Binaries for your OS and architecture will be located in the build/ directory.

From Source

go build -o atlas.bench .

โŒจ๏ธ Usage

Basic Comparison

Compare the execution time of two different runtimes:

atlas.bench "node app.js" "bun app.js"

High-Precision Audit

Run a deep audit with 100 iterations and 10 warm-up cycles to eliminate outliers:

atlas.bench --runs 100 --warmup 10 "python3 process.py" "go run main.go"

Options & Flags

Flag Shorthand Description Default
--runs -r Number of timed iterations per command 10
--warmup -w Number of unmeasured initial runs 3
--timeout -t Max time allowed per run (e.g., 5s, 100ms) 0 (None)
--shell -s Shell to use (default: powershell.exe on Windows, sh on others) ""

๐Ÿ•น๏ธ Controls

Key Action
q or Ctrl+C Abort: Stop all current benchmarks and exit.
Enter Detail View: Deep dive into specific run data (Coming soon).
r Restart: Wipe results and run the current benchmark again.

๐Ÿ“ Statistics Explained

Atlas Bench doesn't just look at the total time; it analyzes the distribution:

  • Mean (Average): The standard "middle ground" of all runs.
  • Median: The middle value, which is more resistant to "spiky" outliers than the mean.
  • StdDev (Standard Deviation): Measures how much the results vary. A high StdDev suggests that the command's performance is being affected by background tasks or inconsistent system resources.
  • The "Winner": The command with the lowest Mean execution time across all timed runs.

๐Ÿ—๏ธ Architecture & Philosophy

  • Local-First: No data ever leaves your machine. Configuration and results stay in your terminal.
  • Concurrency: Benchmarks are run sequentially to avoid resource contention (CPU/IO interference), ensuring the most accurate measurement possible.
  • Engine: Built using bubbletea for the state machine and lipgloss for styling. Orchestrated by gobake.

๐Ÿ“„ License

MIT License - Copyright (c) 2026 FezCode.

About

๐ŸŽ๏ธ High-precision, multi-command TUI benchmarking tool with statistical rigor and side-by-side comparisons. Part of the Atlas Suite.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

ย 
ย 
ย 

Contributors

Languages