gitwtfhub

wtf is instruments?

tekzer0/instruments — explained in plain English

Analysis updated 2026-05-18

5PythonAudience · vibe coderComplexity · 3/5Setup · moderate

TL;DR

Two lightweight scrapers that publish a used-GPU cost-per-tokens-per-second index and a registry of cloud-dependent smart devices.

Mindmap

mindmap
  root((instruments))
    What it does
      GPU price and benchmark index
      Cloud death device registry
      Scheduled cron based scraping
    Tech stack
      Python
      SQLite
      Cron
    Use cases
      Compare GPUs by tokens per dollar
      Check if a smart device survives cloud shutdown
      Track past cloud shutdown incidents
    Audience
      Local AI hobbyists
      Hardware shoppers
    Concepts
      Self healing job monitoring
      SQLite as durable dataset
      Telegram alerting on repeated failure

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Find which used GPUs give the best tokens-per-second value for running local AI models.

REASON 2

Check whether a smart home device still works if its cloud service is discontinued.

REASON 3

Run a cheap, mostly unattended scraper and publisher on a tiny 512MB server.

REASON 4

Feed your own llama-bench results into the index to contribute benchmark data.

What's in the stack?

PythonSQLiterequestsTelegram

How it stacks up

tekzer0/instruments1ncendium/aibusteraaronmayeux/ha-hurricane-tracker
Stars555
LanguagePythonPythonPython
Setup difficultymoderatemoderateeasy
Complexity3/53/52/5
Audiencevibe coderops devopsgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Needs a free SoldComps API key for price data and an optional Telegram bot token for alerts.

Wtf does this do

Instruments is a small collection of two automated data tools plus shared plumbing, designed to run cheaply on a tiny Debian server with just 512 megabytes of memory and one CPU core. Both tools quietly gather data on a schedule and publish the results as simple websites, so no one has to remember to run anything by hand. The first tool, called the Observatory, tracks the cost of running AI models locally on your own hardware. It combines sold prices for used graphics cards scraped from the web with community submitted benchmark results, showing how many tokens per second of AI inference you get for every hundred dollars spent on a given card, so someone shopping for local AI hardware can see which cards offer the best value. Benchmarks come from running a tool called llama-bench and dropping the output into a folder, and numbers that look implausible are automatically flagged and left out of the rankings. The second tool, called the Registry, keeps track of which smart home devices still work if their maker's cloud service shuts down, alongside a running log of past cases where a company turning off its servers left customers' hardware unusable. Both tools are live on their own websites. The project follows a few deliberate design rules. Every scheduled job records whether it succeeded or failed, and only after three failures in a row does it send a single alert message through Telegram, rather than repeatedly nagging. If nothing is reported, everything is assumed healthy. The public site always keeps showing the last good data even if a scraping job is currently failing. All the gathered information builds up in a local SQLite database file, treated as the real long term asset, while the specific marketplaces and websites it scrapes are seen as replaceable sources. Getting started involves copying an example environment file, filling in an optional Telegram bot token and a free API key from a pricing data provider, installing a couple of lightweight Python dependencies, and running a handful of command line steps to initialize the database, load benchmarks and prices, and publish the site. A cron schedule can then automate the whole thing going forward.

Yoink these prompts

Prompt 1
Walk me through setting up the .env file and running run.py initdb for this project.
Prompt 2
Explain how the Observatory turns used-GPU prices and llama-bench results into a cost index.
Prompt 3
Show me how to add my own llama-bench output to data/inbox_benchmarks.
Prompt 4
How does the alerting system decide when to send a Telegram message versus stay silent?

Frequently asked questions

wtf is instruments?

Two lightweight scrapers that publish a used-GPU cost-per-tokens-per-second index and a registry of cloud-dependent smart devices.

What language is instruments written in?

Mainly Python. The stack also includes Python, SQLite, requests.

How hard is instruments to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is instruments for?

Mainly vibe coder.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.