FedComp Index

Federal contractor competitive intelligence. Classifies every federal contractor in a state into one of four Posture Classes using two-axis thresholds (volume x frequency) on public award data. Provides pre-classified datasets.

This is the meta-package. It installs:

• fedcomp-index-scoring - two-axis posture classification engine
• fedcomp-index-data - pre-classified contractor datasets

Install

npm install fedcomp-index

Usage

const { classifyContractor, loadState, lookup, PostureClass } = require("fedcomp-index");

// Classify a contractor from contract data
const result = classifyContractor(15_000_000, 8);
console.log(result.postureClass);      // "Class 1"
console.log(result.highVolume);        // true
console.log(result.highFrequency);     // true
console.log(result.obligationDensity); // 1875000

// Load pre-classified data
const contractors = loadState("NV");
console.log(`${contractors.length} contractors classified`);

// Look up by UEI
const c = lookup("CGAKREGGN9J3");
console.log(c.name);        // FLEET VEHICLE SOURCE INC
console.log(c.posture_class);     // Class 1

Classification methodology

Two-axis classification (trailing 5-year window). No composite score.

| Axis | Threshold | What it measures | |------|-----------|-----------------| | Volume | $5M total contract dollars | Scale of all obligated dollars (base + delivery orders) | | Frequency | 3 base contracts | Breadth of competitive base contract wins |

Four Posture Classes from the two axes:

| Posture Class | Volume | Frequency | Competitive profile | |---------------|--------|-----------|-------------------| | Class 1 | >= $5M total | >= 3 base contracts | Systematic winner | | Class 2 | >= $5M total | < 3 base contracts | Concentrated risk | | Class 3 | < $5M total | >= 3 base contracts | Growth pipeline | | Class 4 | < $5M total | < 3 base contracts | Entry level |

Full methodology: fedcompindex.org/methodology

Packages

| Package | What it does | |---------|-------------| | fedcomp-index | Meta-package (this one) | | fedcomp-index-scoring | Posture classification | | fedcomp-index-data | Pre-classified contractor datasets |

Also available on PyPI

pip install fedcomp-index

• fedcomp-index - meta-package
• fedcomp-index-scoring - classification engine
• fedcomp-index-data - pre-classified datasets

Data sources

All public federal records:

• USASpending.gov - award history, dollar amounts, agencies, NAICS, PSC
• SAM.gov - entity registration, certifications, UEI
• SBA.gov - certification verification

Datasets

• Nevada Federal Contractors (HuggingFace)
• Nevada Federal Contract Awards (HuggingFace)
• Nevada Federal Contractors (Kaggle)
• Nevada Federal Contract Awards (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