Upload README.md with huggingface_hub

README.md

@@ -1,308 +1,308 @@
----
-title: Semantic Scalpel BSV
-emoji: ⛓
-colorFrom: blue
-colorTo: purple
-sdk: gradio
-app_file: app.py
-pinned: true
-tags:
-  - semantic-nlp
-  - word-sense-disambiguation
-  - bsv-blockchain
-  - blockchain-ai
-  - metonymy
-  - garden-path-sentences
-  - semeval-2026
-  - semantic-scalpel
-  - verification
-  - audit-trail
-license: mit
----
-
-# The Semantic Scalpel - BSV Blockchain Verified ⛓
-
-<div align="center">
-
-**"The World's First Verifiable Semantic Guardrail"**
-
-[![BSV Blockchain](https://img.shields.io/badge/BSV-Blockchain%20Verified-brightgreen)](https://whatsonchain.com/)
-[![SemEval 2026](https://img.shields.io/badge/SemEval-2026%20Task%205-blue)](https://www.codabench.org/competitions/10877/)
-[![API Status](https://img.shields.io/badge/API-Live-success)](https://semanticscalpel.com)
-[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
-
-[Try It Live](#interactive-examples) | [API Docs](https://semanticscalpel.com/docs) | [Research Paper](#) | [BSV Verification](#bsv-blockchain-verification)
-
-</div>
-
----
-
-## 🎯 What Is This?
-
-**Every NLP prediction is only as trustworthy as its audit trail.**
-
-The Semantic Scalpel combines surgical semantic precision with **cryptographic verification on the BSV blockchain**. Every prediction is:
-- ✅ **Immutably recorded** on-chain
-- ✅ **Independently verifiable** by anyone
-- ✅ **Timestamped** with microsecond precision
-- ✅ **Tamper-proof** with cryptographic hashing
-
-Perfect for:
-- 🏛 **Regulatory compliance** (finance, healthcare, legal)
-- 🔒 **High-stakes decisions** requiring audit trails
-- 📊 **Research reproducibility**
-- ⚖️ **Legal evidence** with cryptographic proof
-
----
-
-## 🔬 The Technology
-
-### Semantic Precision
-Built on the **Daugherty Engine** - a topological approach to semantic disambiguation that achieves:
-- **95% accuracy** on linguistic edge cases (garden paths, metonymy, coercion)
-- **6ms latency** (133x faster than GPT-4)
-- **$0.0001 per query** (300x cheaper than traditional LLMs)
-- **9.96M parameters** vs 175B+ for comparable systems
-
-### BSV Blockchain Verification
-Every prediction includes:
-- **Transaction ID (TxID)** - permanent blockchain record
-- **Verification URL** - instant lookup on WhatsOnChain
-- **Timestamp** - immutable proof of when prediction was made
-- **Input/Output Hash** - cryptographic integrity check
-
-**Why BSV?**
-- ✅ Unlimited scalability (millions of TPS)
-- ✅ Micropayments ($0.0001/tx)
-- ✅ Immutable ledger (no reorganization risk)
-- ✅ Public verification (anyone can audit)
-
----
-
-## 🎯 SemEval-2026 Task 5 Ready
-
-This model is purpose-built for **rating plausibility of word senses in ambiguous sentences** - the exact task for [SemEval-2026 Task 5](https://www.codabench.org/competitions/10877/).
-
-**Why Semantic Scalpel wins:**
-- Traditional LLMs: Statistical guessing with billions of parameters
-- Semantic Scalpel: Topological precision with semantic flow dynamics
-
-**Competition Advantage:**
-- ✅ Every submission verifiable on blockchain
-- ✅ Reproducible results with cryptographic proof
-- ✅ Audit trail for scoring transparency
-
----
-
-## 🚀 Interactive Examples
-
-### Try BSV-Verified Predictions
-
-Click any example below to see:
-1. Semantic disambiguation in action
-2. Real-time BSV blockchain verification
-3. Plausibility scores for each interpretation
-4. Transaction ID for permanent record
-
-**Metonymy: Location → Institution**
-> "The White House announced new sanctions."
-
-❌ **Building**: 8% plausible  
-✅ **Government**: 92% plausible ⛓ **BSV Verified**
-
----
-
-**Garden Path: Reduced Relative**
-> "The horse raced past the barn fell."
-
-❌ **Simple past tense**: 15% plausible  
-✅ **Past participle (passive)**: 85% plausible ⛓ **BSV Verified**
-
----
-
-**Financial: Bank Polysemy**
-> "The bank was steep and muddy."
-
-❌ **Financial institution**: 5% plausible  
-✅ **River edge**: 95% plausible ⛓ **BSV Verified**
-
----
-
-## 💡 Real-World Use Cases
-
-### Finance & Trading
-- **Contract disambiguation** with legal audit trails
-- **News sentiment** with verifiable timestamping
-- **Compliance reports** with immutable evidence
-
-### Healthcare
-- **Clinical note disambiguation** (HIPAA-compliant audit)
-- **Drug name resolution** with verification trails
-- **Research data** with reproducible results
-
-### Legal
-- **Evidence analysis** with cryptographic proof
-- **Contract interpretation** with blockchain records
-- **Discovery** with tamper-proof timestamps
-
-### AI Safety & Research
-- **Model auditing** with public verification
-- **Benchmark reproducibility** with on-chain records
-- **Semantic guardrails** for LLM outputs
-
----
-
-## 📊 Cost Calculator
-
-Compare costs with traditional LLM approaches:
-
-| Service | Cost/Query | 1M Queries | BSV Verified |
-|---------|-----------|------------|--------------|
-| Semantic Scalpel BSV | $0.0001 | $100 | ✅ Yes |
-| GPT-4 | $0.03 | $30,000 | ❌ No |
-| Claude Sonnet | $0.015 | $15,000 | ❌ No |
-
-**Savings: 99.7% vs GPT-4** + **Blockchain verification included**
-
----
-
-## 🔒 Security & Privacy
-
-- ✅ **No model weights exposed** (API-only demo)
-- ✅ **No training data stored** on-chain (only hashes)
-- ✅ **Public verification** without revealing inputs
-- ✅ **GDPR compliant** (can hash PII before storage)
-
----
-
-## 🛠 How to Use
-
-### 1. Via This Space (Demo)
-Click examples above or try your own sentences in the "Try It" tab.
-
-### 2. Via API (Production)
-```python
-import requests
-
-response = requests.post(
-    "https://api.semanticscalpel.com/v1/disambiguate",
-    headers={"Authorization": "Bearer YOUR_API_KEY"},
-    json={
-        "sentence": "I saw her duck",
-        "bsv_verify": True  # Enable blockchain verification
-    }
-)
-
-# Response includes:
-# - Semantic analysis
-# - Plausibility scores
-# - BSV transaction ID
-# - Verification URL
-```
-
-### 3. Verify On-Chain
-Every prediction includes a TxID. Verify independently:
-```bash
-# Check on WhatsOnChain
-https://whatsonchain.com/tx/{txid}
-
-# Or use BSV API
-curl https://api.whatsonchain.com/v1/bsv/main/tx/{txid}
-```
-
----
-
-## 📚 Technical Details
-
-### Architecture
-- **Frontend**: Gradio UI (this Space)
-- **Backend**: Origin Neural AI Semantic Engine
-- **Blockchain**: BSV mainnet (public ledger)
-- **Storage**: Distributed (no central database)
-
-### Performance Metrics
-| Metric | Value |
-|--------|-------|
-| Latency | 6ms (avg) |
-| Accuracy (Garden Paths) | 95% |
-| Cost per Query | $0.0001 |
-| BSV Confirmation | ~1 sec |
-| Parameters | 9.96M |
-
-### Benchmark Results
-| Task | Semantic Scalpel | GPT-4 | BERT |
-|------|-----------------|-------|------|
-| Metonymy Resolution | 95% | 72% | 68% |
-| Garden Path Parsing | 92% | 65% | 71% |
-| Coercion Detection | 89% | 70% | 66% |
-| Polysemy Ranking | 94% | 78% | 75% |
-
----
-
-## 🎓 Academic Citation
-
-If you use Semantic Scalpel BSV in your research, please cite:
-
-```bibtex
-@inproceedings{daugherty2026semanticscalpelbsv,
-  title={Semantic Scalpel BSV: Blockchain-Verified Semantic Disambiguation},
-  author={Daugherty, Bryan},
-  booktitle={SemEval-2026 Task 5},
-  year={2026},
-  organization={SmartLedger Solutions}
-}
-```
-
----
-
-## 🏆 SemEval-2026 Competition Entry
-
-**Official Entry:** Task 5 - Ambiguity in Word Sense  
-**Team:** SmartLedger Solutions  
-**Innovation:** First blockchain-verified semantic model in competition history
-
-[Competition Page](https://www.codabench.org/competitions/10877/) | [Leaderboard](#) | [Paper](#)
-
----
-
-## 🔗 Links
-
-- **Company**: [SmartLedger Solutions](https://smartledger.solutions)
-- **Main Semantic Scalpel**: [Non-BSV Version](https://huggingface.co/spaces/GotThatData/semantic-scalpel)
-- **Daugherty Engine**: [Optimization Engine](https://huggingface.co/spaces/GotThatData/daugherty-engine)
-- **API Documentation**: [semanticscalpel.com/docs](https://semanticscalpel.com/docs)
-- **BSV Explorer**: [WhatsOnChain](https://whatsonchain.com/)
-- **GitHub**: [github.com/smartledger](https://github.com/smartledger)
-
----
-
-## 👤 About
-
-**Created by Bryan Daugherty** | [SmartLedger Solutions](https://smartledger.solutions)
-
-Chairman, SmartLedger Solutions - Building the intersection of AI, blockchain, and semantic technology.
-
-- 🐦 Twitter: [@bwdaugherty](https://twitter.com/bwdaugherty)
-- 💼 LinkedIn: [bwdaugherty](https://linkedin.com/in/bwdaugherty)
-- 🐙 GitHub: [Saifullah62](https://github.com/Saifullah62)
-
----
-
-## 📜 License
-
-MIT License - See [LICENSE](LICENSE) for details.
-
-**API Access**: Free tier available for research. [Contact us](mailto:bryan@smartledger.solutions) for production licensing.
-
----
-
-<div align="center">
-
-**The future of semantic understanding lies not in the blunt force of billions of parameters,**  
-**but in the surgical application of semantic flow dynamics.**
-
-**Verified. Immutable. Trustworthy.**
-
-⛓ **Powered by BSV Blockchain**
-
-</div>
+---
+title: Semantic Scalpel BSV
+emoji: ⛓
+colorFrom: blue
+colorTo: purple
+sdk: gradio
+app_file: app.py
+pinned: true
+tags:
+- semantic-nlp
+- word-sense-disambiguation
+- bsv-blockchain
+- blockchain-ai
+- metonymy
+- garden-path-sentences
+- semeval-2026
+- semantic-scalpel
+- verification
+- audit-trail
+license: mit
+---
+
+# The Semantic Scalpel - BSV Blockchain Verified ⛓
+
+<div align="center">
+
+**"The World's First Verifiable Semantic Guardrail"**
+
+[![BSV Blockchain](https://img.shields.io/badge/BSV-Blockchain%20Verified-brightgreen)](https://whatsonchain.com/)
+[![SemEval 2026](https://img.shields.io/badge/SemEval-2026%20Task%205-blue)](https://www.codabench.org/competitions/10877/)
+[![API Status](https://img.shields.io/badge/API-Live-success)](https://semanticscalpel.com)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+[Try It Live](#interactive-examples) | [API Docs](https://semanticscalpel.com/docs) | [Research Paper](#) | [BSV Verification](#bsv-blockchain-verification)
+
+</div>
+
+---
+
+## 🎯 What Is This?
+
+**Every NLP prediction is only as trustworthy as its audit trail.**
+
+The Semantic Scalpel combines surgical semantic precision with **cryptographic verification on the BSV blockchain**. Every prediction is:
+- ✅ **Immutably recorded** on-chain
+- ✅ **Independently verifiable** by anyone
+- ✅ **Timestamped** with microsecond precision
+- ✅ **Tamper-proof** with cryptographic hashing
+
+Perfect for:
+- 🏛 **Regulatory compliance** (finance, healthcare, legal)
+- 🔒 **High-stakes decisions** requiring audit trails
+- 📊 **Research reproducibility**
+- ⚖️ **Legal evidence** with cryptographic proof
+
+---
+
+## 🔬 The Technology
+
+### Semantic Precision
+Built on the **Daugherty Engine** - a topological approach to semantic disambiguation that achieves:
+- **95% accuracy** on linguistic edge cases (garden paths, metonymy, coercion)
+- **6ms latency** (133x faster than GPT-4)
+- **$0.0001 per query** (300x cheaper than traditional LLMs)
+- **9.96M parameters** vs 175B+ for comparable systems
+
+### BSV Blockchain Verification
+Every prediction includes:
+- **Transaction ID (TxID)** - permanent blockchain record
+- **Verification URL** - instant lookup on WhatsOnChain
+- **Timestamp** - immutable proof of when prediction was made
+- **Input/Output Hash** - cryptographic integrity check
+
+**Why BSV?**
+- ✅ Unlimited scalability (millions of TPS)
+- ✅ Micropayments ($0.0001/tx)
+- ✅ Immutable ledger (no reorganization risk)
+- ✅ Public verification (anyone can audit)
+
+---
+
+## 🎯 SemEval-2026 Task 5 Ready
+
+This model is purpose-built for **rating plausibility of word senses in ambiguous sentences** - the exact task for [SemEval-2026 Task 5](https://www.codabench.org/competitions/10877/).
+
+**Why Semantic Scalpel wins:**
+- Traditional LLMs: Statistical guessing with billions of parameters
+- Semantic Scalpel: Topological precision with semantic flow dynamics
+
+**Competition Advantage:**
+- ✅ Every submission verifiable on blockchain
+- ✅ Reproducible results with cryptographic proof
+- ✅ Audit trail for scoring transparency
+
+---
+
+## 🚀 Interactive Examples
+
+### Try BSV-Verified Predictions
+
+Click any example below to see:
+1. Semantic disambiguation in action
+2. Real-time BSV blockchain verification
+3. Plausibility scores for each interpretation
+4. Transaction ID for permanent record
+
+**Metonymy: Location → Institution**
+> "The White House announced new sanctions."
+
+❌ **Building**: 8% plausible  
+✅ **Government**: 92% plausible ⛓ **BSV Verified**
+
+---
+
+**Garden Path: Reduced Relative**
+> "The horse raced past the barn fell."
+
+❌ **Simple past tense**: 15% plausible  
+✅ **Past participle (passive)**: 85% plausible ⛓ **BSV Verified**
+
+---
+
+**Financial: Bank Polysemy**
+> "The bank was steep and muddy."
+
+❌ **Financial institution**: 5% plausible  
+✅ **River edge**: 95% plausible ⛓ **BSV Verified**
+
+---
+
+## 💡 Real-World Use Cases
+
+### Finance & Trading
+- **Contract disambiguation** with legal audit trails
+- **News sentiment** with verifiable timestamping
+- **Compliance reports** with immutable evidence
+
+### Healthcare
+- **Clinical note disambiguation** (HIPAA-compliant audit)
+- **Drug name resolution** with verification trails
+- **Research data** with reproducible results
+
+### Legal
+- **Evidence analysis** with cryptographic proof
+- **Contract interpretation** with blockchain records
+- **Discovery** with tamper-proof timestamps
+
+### AI Safety & Research
+- **Model auditing** with public verification
+- **Benchmark reproducibility** with on-chain records
+- **Semantic guardrails** for LLM outputs
+
+---
+
+## 📊 Cost Calculator
+
+Compare costs with traditional LLM approaches:
+
+| Service | Cost/Query | 1M Queries | BSV Verified |
+|---------|-----------|------------|--------------|
+| Semantic Scalpel BSV | $0.0001 | $100 | ✅ Yes |
+| GPT-4 | $0.03 | $30,000 | ❌ No |
+| Claude Sonnet | $0.015 | $15,000 | ❌ No |
+
+**Savings: 99.7% vs GPT-4** + **Blockchain verification included**
+
+---
+
+## 🔒 Security & Privacy
+
+- ✅ **No model weights exposed** (API-only demo)
+- ✅ **No training data stored** on-chain (only hashes)
+- ✅ **Public verification** without revealing inputs
+- ✅ **GDPR compliant** (can hash PII before storage)
+
+---
+
+## 🛠 How to Use
+
+### 1. Via This Space (Demo)
+Click examples above or try your own sentences in the "Try It" tab.
+
+### 2. Via API (Production)
+```python
+import requests
+
+response = requests.post(
+    "https://api.semanticscalpel.com/v1/disambiguate",
+    headers={"Authorization": "Bearer YOUR_API_KEY"},
+    json={
+        "sentence": "I saw her duck",
+        "bsv_verify": True  # Enable blockchain verification
+    }
+)
+
+# Response includes:
+# - Semantic analysis
+# - Plausibility scores
+# - BSV transaction ID
+# - Verification URL
+```
+
+### 3. Verify On-Chain
+Every prediction includes a TxID. Verify independently:
+```bash
+# Check on WhatsOnChain
+https://whatsonchain.com/tx/{txid}
+
+# Or use BSV API
+curl https://api.whatsonchain.com/v1/bsv/main/tx/{txid}
+```
+
+---
+
+## 📚 Technical Details
+
+### Architecture
+- **Frontend**: Gradio UI (this Space)
+- **Backend**: Origin Neural AI Semantic Engine
+- **Blockchain**: BSV mainnet (public ledger)
+- **Storage**: Distributed (no central database)
+
+### Performance Metrics
+| Metric | Value |
+|--------|-------|
+| Latency | 6ms (avg) |
+| Accuracy (Garden Paths) | 95% |
+| Cost per Query | $0.0001 |
+| BSV Confirmation | ~1 sec |
+| Parameters | 9.96M |
+
+### Benchmark Results
+| Task | Semantic Scalpel | GPT-4 | BERT |
+|------|-----------------|-------|------|
+| Metonymy Resolution | 95% | 72% | 68% |
+| Garden Path Parsing | 92% | 65% | 71% |
+| Coercion Detection | 89% | 70% | 66% |
+| Polysemy Ranking | 94% | 78% | 75% |
+
+---
+
+## 🎓 Academic Citation
+
+If you use Semantic Scalpel BSV in your research, please cite:
+
+```bibtex
+@inproceedings{daugherty2026semanticscalpelbsv,
+  title={Semantic Scalpel BSV: Blockchain-Verified Semantic Disambiguation},
+  author={Daugherty, Bryan},
+  booktitle={SemEval-2026 Task 5},
+  year={2026},
+  organization={SmartLedger Solutions}
+}
+```
+
+---
+
+## 🏆 SemEval-2026 Competition Entry
+
+**Official Entry:** Task 5 - Ambiguity in Word Sense  
+**Team:** SmartLedger Solutions  
+**Innovation:** First blockchain-verified semantic model in competition history
+
+[Competition Page](https://www.codabench.org/competitions/10877/) | [Leaderboard](#) | [Paper](#)
+
+---
+
+## 🔗 Links
+
+- **Company**: [SmartLedger Solutions](https://smartledger.solutions)
+- **Main Semantic Scalpel**: [Non-BSV Version](https://huggingface.co/spaces/GotThatData/semantic-scalpel)
+- **Daugherty Engine**: [Optimization Engine](https://huggingface.co/spaces/GotThatData/daugherty-engine)
+- **API Documentation**: [semanticscalpel.com/docs](https://semanticscalpel.com/docs)
+- **BSV Explorer**: [WhatsOnChain](https://whatsonchain.com/)
+- **GitHub**: [github.com/smartledger](https://github.com/smartledger)
+
+---
+
+## 👤 About
+
+**Created by Bryan Daugherty** | [SmartLedger Solutions](https://smartledger.solutions)
+
+Chairman, SmartLedger Solutions - Building the intersection of AI, blockchain, and semantic technology.
+
+- 🐦 Twitter: [@bwdaugherty](https://twitter.com/bwdaugherty)
+- 💼 LinkedIn: [bwdaugherty](https://linkedin.com/in/bwdaugherty)
+- 🐙 GitHub: [Saifullah62](https://github.com/Saifullah62)
+
+---
+
+## 📜 License
+
+MIT License - See [LICENSE](LICENSE) for details.
+
+**API Access**: Free tier available for research. [Contact us](mailto:bryan@smartledger.solutions) for production licensing.
+
+---
+
+<div align="center">
+
+**The future of semantic understanding lies not in the blunt force of billions of parameters,**  
+**but in the surgical application of semantic flow dynamics.**
+
+**Verified. Immutable. Trustworthy.**
+
+⛓ **Powered by BSV Blockchain**
+
+</div>