Documentation on Signal Room

Quick Start

Mon, 01 Jan 0001 00:00:00 +0000

Requires python3, bash, git, and (for deploys) the gh CLI. Building and serving the Hugo/Docsy site additionally requires hugo (extended) and node/npm.

Build the report

# Build the dashboard from the JSON data inputs
bash src/scripts/build.sh

# Validate JSON + rebuild + sanity-check the artifact
bash src/scripts/release-check.sh

# Open the current report directly, without the documentation site
xdg-open dist/dashboard.html

Build and serve the documentation site

# Serve the Hugo/Docsy site locally at http://localhost:1313/, embedding a
# freshly built report
bash docs/scripts/serve-docs.sh

# Produce a production build under docs/public/
bash docs/scripts/build-docs.sh

docs/scripts/build-docs.sh and docs/scripts/serve-docs.sh both rebuild dist/dashboard.html via src/scripts/build.sh and copy it to static/report/dashboard.html before invoking Hugo, so the embedded report in Signal Room always reflects the current data.

Project Status

Mon, 01 Jan 0001 00:00:00 +0000

Lifecycle: active. The market roster and published dashboard are actively maintained. Historical snapshots, when published, remain available for provenance, but only the current dashboard and latest tagged release are supported.

For the live revision, archived-snapshot policy, and release links, see Revisions.

What this is

Signal Room is inspectable decision support: a manually rebuilt, single static dashboard that tracks model rosters, provider-native reasoning configurations, speed evidence, agent harnesses, and self-hosting economics, with evidence classes and source links kept visible throughout.

Data Methodology

Mon, 01 Jan 0001 00:00:00 +0000

The dashboard has three canonical data inputs:

data/market-state.json preserves the original report schema and backward compatibility.
data/model-roster-v2.json contains the curated provider roster, model configuration levels, availability, pricing labels, and speed evidence.
data/report-metrics.json contains normalized metrics, chart encodings, current economics, hardware fit, and decision-support data.

The build validates all three files and merges the latter two under marketData.model_roster and marketData.report_metrics. Do not fetch data at runtime: GitHub Pages remains a single, manually rebuilt static artifact.

Research Data Policy

Mon, 01 Jan 0001 00:00:00 +0000

This policy applies to market facts, benchmark observations, pricing, availability, source links, and historical snapshots used by the Signal Room.

Source rights and collection

Use sources that are publicly accessible and lawful to consult. Prefer primary sources such as official model cards, documentation, pricing pages, release notes, repositories, and benchmark publications. Do not bypass access controls, paywalls, authentication, rate limits, or technical restrictions.

Store only the facts and short summaries needed for market analysis. Do not mirror articles, proprietary datasets, benchmark submissions, or other copyrighted source material. A public URL does not imply permission to copy the underlying work.