🛡️ ContractSentinel

AI Contract-Risk Analyzer — a local-first LangGraph agent that finds, scores, and rewrites risky clauses

Upload a contract → every risky clause found, scored, and redlined — with an evidence trail, a branded PDF, and delivery to your own Drive & inbox. Run it fully offline on local models, or deploy it to the cloud — same pipeline, swappable providers.

---

📌 Overview

ContractSentinel is an autonomous, AI-powered system that reads a legal contract and tells you where the risk is. A user uploads a PDF or DOCX; a fixed 7-node LangGraph pipeline splits it into clauses, retrieves supporting legal evidence for each one, validates which clauses are genuinely worth flagging, scores each Low / Medium / High with a written rationale, drafts a safer rewrite for the risky ones, and compiles a branded PDF report — delivered to the user's own Google Drive and emailed to them.

It behaves like a real multi-tenant SaaS — landing page, authentication, per-user data isolation, per-user Drive, live progress streaming, a metrics dashboard and report history — built spec-first with a strict review gate.

Two ways to run the exact same pipeline, chosen by a clean provider seam:

Mode	Generation	Embeddings	Data	Privacy
🏠 Local-first (default)	Qwen3:8b via Ollama	BGE-M3 via Ollama	SQLite	💯 Contract text never leaves the machine
☁️ Cloud deployment	Groq gpt-oss-120b	Cloudflare bge-m3	Turso (libSQL)	Hosted demo on Render + Vercel

The architecture, nodes, prompts, and tests are identical across both modes — only the provider adapters change. That seam is what lets a privacy-first local tool also ship as a live hosted demo without a rewrite.

---

📊 At a Glance

🧠 Pipeline	📚 Knowledge Base	🧪 Tests	🔒 Security	📐 Process
7 nodes · 2 edges fixed LangGraph	1,400+ real clauses · 39 types (CUAD + Bonterms)	1,231 backend · 264 frontend	8 hardening layers	66 spec-reviewed features

---

📖 Table of Contents

• Highlights
• Local-First by Design
• Architecture — the 7-Node Graph
• The 7-Node Pipeline
• Request Lifecycle
• Deployment Architecture
• Model Provider Seam
• Tech Stack
• Project Structure
• Getting Started
• Running the App
• Testing
• Security
• Reliability & Performance
• Development Methodology
• Project Status
• Team
• License

---

This is the beginning of the README. Read the rest at the original. Read the full README ↗