Upload Readme.md

Readme.md

@@ -0,0 +1,86 @@
+---
+title: Dr Drastic Unified Evidence Engine
+emoji: "\U000026A1"
+colorFrom: blue
+colorTo: green
+sdk: gradio
+sdk_version: 6.18.0
+python_version: "3.12"
+app_file: app.py
+fullWidth: true
+pinned: false
+license: mit
+---
+
+# Dr Drastic: Unified Evidence Engine
+
+This project fuses the strongest parts of the two original Gradio bots into one
+testable application:
+
+- PDF, DOCX, TXT, Markdown and CSV ingestion
+- role classification and source IDs
+- pasted or document-derived chronology extraction
+- event tagging and evidence-pack completeness scoring
+- potential contradiction and omission review
+- source-linked evidence matrix
+- legal and regulatory route suggestions
+- grounded Queen Nala AI rulings with streaming responses and source-ID citations
+- configurable Hugging Face inference model/provider and session knowledge base
+- Markdown ruling transcript export
+- text-to-speech for key panels
+- TXT, JSON, DOCX and ZIP exports
+- per-session Gradio state instead of a process-wide global result
+
+## Run
+
+```powershell
+python -m pip install -r requirements.txt
+python app.py
+```
+
+This workspace already includes a local virtual environment:
+
+```powershell
+.\.venv\Scripts\python.exe app.py
+```
+
+For AI rulings, set a Hugging Face token locally or add `HF_TOKEN` as a Space
+secret:
+
+```powershell
+$env:HF_TOKEN = "hf_..."
+```
+
+## Hugging Face Pro
+
+With a **Hugging Face Pro** account, Queen Nala automatically prefers
+`hf-inference` then `auto` routing for better HF router access and higher
+limits. Pro status is detected once per process via `whoami` when a token is
+available.
+
+| Environment | Token setup |
+|-------------|-------------|
+| Hugging Face Spaces | Space secret `HF_TOKEN` (Inference Providers permission) |
+| GitHub Actions / Codespaces | Repository or user secret `HF_TOKEN` or `HUGGING_FACE_HUB_TOKEN` |
+| Local / Docker | `$env:HF_TOKEN = "hf_..."` or `hf auth login` |
+
+The Queen Nala tab shows a subtle routing hint when Pro is active. Pro users
+get fewer provider hops and retries to avoid retry storms on transient outages.
+
+### Docker
+
+```powershell
+docker build -t dr-drastic .
+docker run --rm -p 7860:7860 -e HF_TOKEN=hf_... dr-drastic
+```
+
+## Test
+
+The core tests do not require Gradio or document-export packages:
+
+```powershell
+python -m unittest discover -s tests -v
+```
+
+Automated findings are review leads, not legal conclusions or legal advice.
+Verify every output against the original source documents and current law.