Update README.md

README.md

@@ -6,5 +6,62 @@ colorTo: red
 sdk: docker
 pinned: false
 ---
+## ⚖️ LEX - Legal Expert Agentic System
+LEX is an AI-powered legal analysis system designed to bridge the "Access to Justice Gap". It helps users navigate intimidating legal documents and proceedings by providing immediate clarity through a sophisticated multi-agent workflow.
++4
+
+## 🏗️ System Architecture: Optimized Parallel Pipeline
+LEX utilizes an AISA (Agentic Interactive System Architecture) workflow that runs 6 specialized agents across 4 logical phases. To ensure a professional and responsive user experience, the system employs Python's ThreadPoolExecutor to reduce processing time from ~20 seconds to just 10–12 seconds.
+
+## 🚀 Setup & Installation
+- Prerequisites
+Python 3.9+
+OpenAI API Key (Optimized for gpt-4o-mini) 
+Required Libraries: pydantic, faiss-cpu, sqlite3, concurrent.futures
+
+- Installation
+Clone the repository:
+Bash: git clone https://huggingface.co/spaces/AISA-Framework/LEX-AdeemAlotaibi
+cd LEX-AdeemAlotaibi
+
+Install dependencies:
+Bash: pip install -r requirements.txt
+
+Configure Environment:
+Set AISA_DETERMINISTIC=1 for reproducible test results
+
+
+
+## 🛠️ Usage
+
+LEX is designed to be intuitive for users facing legal stress.The system processes messy, real-world text and converts it into a structured legal analysis.
+
+### 1. Inputting a Case
+[cite_start]Users can input their legal situation in the text area (up to 8,000 characters).This can include:
+* [cite_start]**Narratives:** Describing a dispute or situation in plain language.
+* [cite_start]**Document Text:** Pasting the content of a termination notice, contract clause, or court judgment. 
+* [cite_start]**Multilingual Input:** Input can be in Arabic or English; the system is robust enough to categorize and analyze both. 
+
+### 2. The Analysis Process
+[cite_start]Once submitted, the system triggers the **AISA Workflow**: [cite: 11]
+* [cite_start]**Instant Identification:** The system immediately identifies the "Intent" (e.g., is this a notice, a contract, or a judgment?). [cite: 30, 32]
+* [cite_start]**Plain Language Explanation:** It translates complex legal jargon into an easy-to-understand summary using the RAG tool. [cite: 33, 54]
+* **Automated Quality Check:** The Critic Agent reviews the analysis. [cite_start]If it misses a key legal point (like a specific 90-day notice rule), it automatically re-runs the logic to ensure accuracy. [cite: 37, 49]
+
+### 3. Understanding the Output
+[cite_start]The user receives an **Analysis Report** containing: [cite: 71, 75]
+* [cite_start]**Summary:** A clear explanation of "what is happening." [cite: 34]
+* [cite_start]**Risk Assessment:** A visual indicator of the risk level (Low, Medium, or High). [cite: 40, 68]
+* [cite_start]**Action Plan:** Targeted next steps (e.g., "mentions notice period violation" or "first action step urgency=high"). [cite: 39, 68]
+* [cite_start]**Key Points:** Critical legal facts detected by the Reasoning Agent. [cite: 66, 68]
+
+### 4. Example Scenarios
+| Scenario | Expected Output |
+| :--- | :--- |
+| **Landlord Notice** | [cite_start]Intent: `Notice`, Risk: `Medium`, Action: Notice period validation. [cite: 68] |
+| **Salary Reduction** | [cite_start]Intent: `Contract`, Risk: `Medium`, Action: Wage violation check. [cite: 68] |
+| **Court Judgment** | [cite_start]Intent: `Judgment`, Risk: `High`, Action: Urgent payment/appeal steps. [cite: 68] |
+
 
 Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+