fedcomp-index-scoring
v2026.3.7
Published
FedComp Index classification engine. Two-axis posture classification (volume x frequency) for federal contractors from USASpending award data.
Maintainers
Keywords
Readme
FedComp Index Classification

Federal contractor posture classification. Classifies any federal contractor into one of four Posture Classes using two-axis thresholds on public award data from USASpending.gov.
Each contractor is classified along two independent axes: award volume (total contract dollars including delivery orders) and award frequency (base contracts only), over a trailing 5-year window:
- Class 1 - high volume + high frequency (systematic winners, $5M+ total across 3+ base contracts)
- Class 2 - high volume + low frequency (concentrated risk, $5M+ total but fewer than 3 base contracts)
- Class 3 - low volume + high frequency (growth pipeline, under $5M total but 3+ base contracts)
- Class 4 - low volume + low frequency (entry level)
Install
npm install fedcomp-index-scoringUsage
const { classifyContractor, PostureClass } = require("fedcomp-index-scoring");
const result = classifyContractor(15_000_000, 8);
result.postureClass; // "Class 1"
result.highVolume; // true
result.highFrequency; // true
result.obligationDensity; // 1875000Classification methodology
Two-axis classification. Volume counts all contract types (base + delivery orders). Frequency counts definitive contracts and purchase orders only (BPA calls, delivery orders, and task orders excluded).
| Axis | Threshold | What it measures | |------|-----------|-----------------| | Volume | $5M total contract dollars (5yr) | Scale of all obligated dollars | | Frequency | 3 base contracts (5yr) | Breadth of competitive wins |
The two axes are independent dimensions. Neither can be derived from the other. A contractor with $50M across 2 base contracts and a contractor with $50M across 20 base contracts are fundamentally different competitive species, even though their volume is identical. Obligation Density (OD) = total dollars / base contracts.
| Posture Class | Volume | Frequency | Competitive profile | |---------------|--------|-----------|-------------------| | Class 1 | >= $5M total | >= 3 base contracts | Systematic winner, repeatable pipeline | | Class 2 | >= $5M total | < 3 base contracts | Concentrated risk, few large wins | | Class 3 | < $5M total | >= 3 base contracts | Growth pipeline, building momentum | | Class 4 | < $5M total | < 3 base contracts | Entry level |
Obligation density (dollars per base contract) is computed as a derived metric but does not affect classification.
Full methodology: fedcompindex.org/methodology
Related packages
| Package | What it does | |---------|-------------| | fedcomp-index | Meta-package (installs both) | | fedcomp-index-scoring | Classification engine (this one) | | fedcomp-index-data | Pre-classified contractor datasets |
Also available on PyPI
pip install fedcomp-index-scoring- fedcomp-index - meta-package
- fedcomp-index-scoring - classification engine
- fedcomp-index-data - pre-classified datasets
Data sources
All data is sourced from public federal records:
- USASpending.gov - award history, dollar amounts, agencies, NAICS codes, PSC codes
- SAM.gov - entity registration, certifications, UEI
- SBA.gov - small business certification verification
Live classifications
Classified contractor rankings with dossier pages, proximity maps, and velocity tracking:
- Nevada - 779 contractors classified
Datasets
Pre-classified datasets available for download:
- Nevada Federal Contractors - FedComp Index (HuggingFace)
- Nevada Federal Contract Awards - Monthly (HuggingFace)
- Nevada Federal Contractors - FedComp Index (Kaggle)
- Nevada Federal Contract Awards - Monthly (Kaggle)
Links
- Website: https://fedcompindex.org/
- Nevada Rankings: https://fedcompindex.org/nv/
- Methodology: https://fedcompindex.org/methodology/
- Tabularium: https://fedcompindex.org/tabularium/
- FAQ: https://fedcompindex.org/faq/
- Source: https://github.com/fedcompindex/FedCompIndex
- PyPI: https://pypi.org/project/fedcomp-index/
- HuggingFace: https://huggingface.co/datasets/npetro6/nevada-federal-contractors
- Kaggle: https://www.kaggle.com/datasets/npetro6/nevada-federal-contractors-fedcomp-index
Citation
@software{fedcomp_index,
title = {FedComp Index},
author = {FedComp Index},
url = {https://fedcompindex.org/},
year = {2026}
}License
MIT
