Skip to main content

Federal contractor competitive intelligence. Two-axis classification (volume x frequency), four Posture Classes, and classified datasets for every federal contractor.

Project description

FedComp Index

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:

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

Also available on npm

npm install fedcomp-index

Links

Citation

@software{fedcomp_index,
  title = {FedComp Index},
  author = {FedComp Index},
  url = {https://fedcompindex.org/},
  year = {2026}
}

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fedcomp_index-2026.4.1.tar.gz (4.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

fedcomp_index-2026.4.1-py3-none-any.whl (4.8 kB view details)

Uploaded Python 3

File details

Details for the file fedcomp_index-2026.4.1.tar.gz.

File metadata

  • Download URL: fedcomp_index-2026.4.1.tar.gz
  • Upload date:
  • Size: 4.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.11

File hashes

Hashes for fedcomp_index-2026.4.1.tar.gz
Algorithm Hash digest
SHA256 5b40f823bc42724eb3f78034082a4d4cc91b1b2ca1018feda939e900ceb3ae8d
MD5 bbeacabd079aba4acbfac37816944c35
BLAKE2b-256 cdb930eb0fd79002b5655bedb22466b23c0a18d41a10b350c05cceab904f346e

See more details on using hashes here.

File details

Details for the file fedcomp_index-2026.4.1-py3-none-any.whl.

File metadata

File hashes

Hashes for fedcomp_index-2026.4.1-py3-none-any.whl
Algorithm Hash digest
SHA256 e3645fb8cf9ff5c528c3dd975a5a7f3a00e76a2f9be3ce7cd2c521ef942f5ab6
MD5 713f4fe7b69c50bcd076604b3a107f24
BLAKE2b-256 742e885fcb08c3ab832c74d88f98cf69246731278dd9c7a7a3fb36191d6b143e

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page