How To Use SPEC Aggregator

Search Configs

Use the home page workflow cards to search, compare, or open the advisor. Search values like 8380 or 9374F, then click a config key to open details.

Config Detail

Open /config/2x8380 to see a humanized platform profile, generation, sockets, cores, vendor diversity, benchmark medians, samples, standard deviation, and confidence.

Compare Tool

Open /compare-tool to compare platforms without editing URLs. Both left and right inputs show live suggestions while typing.

Compare

Use the compare form or open /compare?left=2x8380&right=2x9374F&prefer_rate=true. The page includes humanized platform headers, executive summary, confidence explanations, and vendor diversity.

Export

Click Export CSV on a compare page, or use /export/compare with the same query params.

Migration Advisor

Open /advisor, enter a current platform, and review ranked candidates with expected gain, confidence, platform similarity, rationale, Compare, and Provenance actions.

Platform Families

Open /families to explore observed platform generations such as Genoa, Turin, Bergamo, Ice Lake, and Sapphire Rapids. Family pages group by config key and support socket filters.

Provenance

Open /provenance/2x8380 to inspect raw public submissions. Click a system name to open a concrete submission detail page with system configuration, matched benchmark tests, and SPEC disclosure links.

APIs

Use /api/recommend?target=2x8380, /api/provenance/2x8380, /api/stats, and the existing search/compare APIs for automation.

API Docs

Open Swagger API Docs for all available endpoints.

Project File

The full guide is stored in docs/user_guide.md.