FedComp Index
Federal contractor competitive intelligence. Classifies every federal contractor in a state into one of four Posture Classes using two-axis thresholds on USASpending award data, then provides proximity maps, velocity tracking, and pre-classified datasets.
This is the meta-package. It installs:
- fedcomp-index-scoring - posture classification engine
- fedcomp-index-data - pre-classified contractor datasets
Install
pip install fedcomp-index
Usage
from fedcomp_index import classify, classify_contractor, load_state, lookup, PostureClass
# Classify a contractor from two axes
cls = classify(total_dollars=12_000_000, base_contract_count=5)
print(cls) # PostureClass.CLASS_1
# Get a full result object
result = classify_contractor(total_dollars=12_000_000, base_contract_count=5)
print(result.posture_class) # PostureClass.CLASS_1
print(result.total_dollars) # 12000000
print(result.base_contract_count) # 5
# Load pre-classified data
contractors = load_state("NV")
print(f"{len(contractors)} contractors classified")
# Look up by UEI
c = lookup("CGAKREGGN9J3")
print(c["legal_name"]) # FLEET VEHICLE SOURCE INC
print(c["posture_class"]) # Class 1
Classification methodology (v1.1)
Two axes, no composite score, no weighted sum:
| Axis | Threshold | What it measures |
|---|---|---|
| Total contract dollars (5yr) | $5M | Volume of all obligated dollars (base + delivery orders) |
| Base contract count (5yr) | 3 | Frequency of distinct base contract wins |
Volume includes all contract types (base + delivery orders). Frequency counts base contracts only.
| Posture Class | Volume | Frequency | Profile |
|---|---|---|---|
| Class 1 | $5M+ total | 3+ base contracts | Systematic winner, repeatable pipeline |
| Class 2 | $5M+ total | <3 base contracts | Concentrated risk, few large awards |
| Class 3 | <$5M total | 3+ base contracts | Growth pipeline, building track record |
| Class 4 | <$5M total | <3 base contracts | Entry level or dormant |
Full methodology: fedcompindex.org/methodology
Packages
| Package | What it does |
|---|---|
| fedcomp-index | Meta-package (this one) |
| fedcomp-index-scoring | Posture classification engine |
| fedcomp-index-data | Pre-classified contractor datasets |
Data sources
All public federal records:
- USASpending.gov - award history, dollar amounts, agencies, NAICS, PSC
- SAM.gov - entity registration, certifications
- SBA.gov - certification verification
Datasets
- Nevada Federal Contractors (HuggingFace)
- Nevada Federal Contract Awards (HuggingFace)
- Nevada Federal Contractors (Kaggle)
Also available on npm
npm install fedcomp-index
- fedcomp-index - meta-package
- fedcomp-index-scoring - classification engine
- fedcomp-index-data - pre-classified datasets
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/
- PyPI (Scoring): https://pypi.org/project/fedcomp-index-scoring/
- PyPI (Data): https://pypi.org/project/fedcomp-index-data/
- 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
Metadata
Release files for fedcomp-index 2026.4.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| fedcomp_index-2026.4.1.tar.gz | 4.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| fedcomp_index-2026.4.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 9.6 kB
Release files / fedcomp_index-2026.4.1.tar.gz
| Download URL | fedcomp_index-2026.4.1.tar.gz |
|---|---|
| Size | 4.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5b40f823bc42724eb3f78034082a4d4cc91b1b2ca1018feda939e900ceb3ae8d
|
|
BLAKE2b-256 checksum How to use checksums |
cdb930eb0fd79002b5655bedb22466b23c0a18d41a10b350c05cceab904f346e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.11
|
Release files / fedcomp_index-2026.4.1-py3-none-any.whl
| Download URL | fedcomp_index-2026.4.1-py3-none-any.whl |
|---|---|
| Size | 4.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e3645fb8cf9ff5c528c3dd975a5a7f3a00e76a2f9be3ce7cd2c521ef942f5ab6
|
|
BLAKE2b-256 checksum How to use checksums |
742e885fcb08c3ab832c74d88f98cf69246731278dd9c7a7a3fb36191d6b143e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.11
|