Files
blt/README.md
Gregory Ballantine cb55a19ada
Some checks are pending
ci/woodpecker/push/woodpecker Pipeline is pending
Switching from air to fresh for auto-reloading
2025-10-02 14:42:14 -04:00

1.6 KiB

Benchmark Logging Tool (BLT)

Build badge

Web-based tool to store and organize PC hardware benchmarks.

Project Goals

The goals of this project are to:

  • Record benchmarking results from multiple devices - e.g. log from a laptop or a phone.
  • Group results into tests to keep track of different testing configurations.
  • Encourage running tests multiple times - it's good practice to run a benchmark multiple times for accuracy.
  • Create comparisons of hardware tests to compare performance.
  • Generate graphs of hardware comparisons for usage in videos and articles.

Requirements

BLT runs on Go. It uses the built-in go mod tool to manage dependencies, thus there is no external tooling to install to build/run BLT.

Debian/Ubuntu: apt install -y golang RedHat and clones: dnf install -y golang

Production Deployment

TODO

Development

Via Docker

TODO

Local/Native Development

BLT uses fresh to auto-reload the app. While this is not strictly necessary, it used to make development more convenient. If you wish to forego installing it, you may simply build and run the app with the standard go run main.go.

  1. Install dependencies:

go mod download

  1. Install fresh to auto-reload the app:

go install github.com/gravityblast/fresh@latest

  1. Run the app via air:

fresh

  1. If everything is running successfully you can open your browser and go to http://localhost:2830.

License

This project is available under the BSD 2-Clause license.