Spaces:
Sleeping
Sleeping
| title: EPCC Contract Intelligence | |
| emoji: 📑 | |
| colorFrom: blue | |
| colorTo: indigo | |
| sdk: docker | |
| app_port: 7860 | |
| pinned: false | |
| license: mit | |
| short_description: Local clause/risk classifier for EPCC contract triage | |
| # EPCC Contract Intelligence — live demo | |
| A leakage-safe, severity-weighted clause/risk classifier for Engineering, | |
| Procurement, Construction & Commissioning (EPCC) contract review. Fully | |
| local model — no external API calls at inference time. | |
| - **Model**: `BAAI/bge-small-en-v1.5` sentence embeddings + logistic | |
| regression head, trained on the public | |
| [CUAD](https://huggingface.co/datasets/dvgodoy/CUAD_v1_Contract_Understanding_clause_classification) | |
| dataset (13,155 attorney-labelled clauses across 509 commercial contracts, | |
| 41 clause types). | |
| - **Held-out test** (102 contracts, ≈2,850 clauses, zero contract overlap | |
| with training): macro-F1 0.637, critical-tier false-negative rate 0.075, | |
| abstain at p≥0.45 → coverage 0.567 / accuracy 0.903. | |
| - **Source code, executive memo, notebook, and tests**: | |
| [github.com/maralzar/epcc-contract-intelligence](https://github.com/maralzar/epcc-contract-intelligence) | |
| ## How to use | |
| 1. **Classify a clause** — paste your own or pick one of the 15 synthetic | |
| EPCC excerpts (C1–C15). The slider tunes the abstain threshold; clauses | |
| with confidence below it route to human review. | |
| 2. **Synthetic EPCC packet** — see the full pre-computed risk register for | |
| all 15 excerpts. | |
| 3. **About / metrics** — held-out test metrics, the severity-tier map, and | |
| stated limitations. | |
| ## What you're looking at | |
| The model is a methodology proof: CUAD covers commercial / M&A contracts, | |
| not EPCC, so the demo shows transferable behaviour. The classifier predicts | |
| confidently on liability-cap / LD / insurance clauses (which match CUAD | |
| labels) and **correctly abstains** on EPCC-native concepts CUAD never saw | |
| (force majeure, site conditions, change in law, notice/waiver). The abstain | |
| layer is doing real product work — that's the design point. | |
| ## Limitations | |
| - Trained on CUAD, not on real EPCC contract data. Production needs SME- | |
| labelled EPCC data on top of an extended taxonomy. | |
| - Single-label per clause; real EPCC review is multi-label. | |
| - Text-only ingestion. Real bid packages arrive as scanned PDFs; OCR is | |
| part of the production architecture, not this demo. | |
| - The system is **assistive**, not autonomous. Legal & commercial teams | |
| remain final decision-makers. | |
| License: MIT. CUAD is CC-BY-4.0 (Hendrycks et al., NeurIPS 2021). | |