Spaces:
Runtime error
Runtime error
Commit Β·
16f7cf4
1
Parent(s): ca4ed58
update README
Browse files
README.md
CHANGED
|
@@ -1,7 +1,7 @@
|
|
| 1 |
-
# ClaimCheck.AI β Agentic Fact Verification for Calls
|
| 2 |
|
| 3 |
**ClaimCheck.AI** is an agentic AI pipeline that turns meeting audio (Zoom/phone) into an evidence-backed report:
|
| 4 |
-
1) **ASR Agent
|
| 5 |
2) **Claim Extraction (watsonx.ai LLM)** β JSON claims
|
| 6 |
3) **Evidence Retrieval (watsonx.ai Embeddings + FAISS + optional Rerank)** β KB hits
|
| 7 |
4) **Verification (watsonx.ai LLM)** β supported/refuted/insufficient + citations
|
|
@@ -9,7 +9,7 @@
|
|
| 9 |
|
| 10 |
## β¨ Why it matters
|
| 11 |
High-stakes calls contain promises and metrics (SLA, compliance, finance). ClaimCheck.AI verifies statements against your **trusted KB** so decisions are grounded in factsβnot memory.
|
| 12 |
-
|
| 13 |
---
|
| 14 |
|
| 15 |
## π§ Project structure
|
|
@@ -27,7 +27,7 @@ claim-check/
|
|
| 27 |
β β ββ json_utils.py # robust JSON extraction from LLM outputs
|
| 28 |
β ββ schemas/ # pydantic models (Claim, Evidence, Verdict, CallReport)
|
| 29 |
β ββ services/
|
| 30 |
-
β β ββ asr.py #
|
| 31 |
β ββ main.py # FastAPI: /health, /process-audio, /process-transcript
|
| 32 |
ββ kb/
|
| 33 |
β ββ snippets.jsonl # your knowledge base (facts; one JSON per line)
|
|
@@ -117,12 +117,18 @@ curl http://127.0.0.1:8000/health/ibm
|
|
| 117 |
|
| 118 |
## π§ How it works (agentic)
|
| 119 |
|
| 120 |
-
|
| 121 |
-
|
| 122 |
-
|
| 123 |
-
|
| 124 |
-
|
| 125 |
-
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 126 |
|
| 127 |
---
|
| 128 |
|
|
@@ -139,7 +145,4 @@ curl http://127.0.0.1:8000/health/ibm
|
|
| 139 |
- **OpenMP error (macOS)** β set `KMP_DUPLICATE_LIB_OK=TRUE` and `OMP_NUM_THREADS=1`.
|
| 140 |
- **JSON parse errors** β we use a robust extractor; check server logs `[RAW OUTPUT]`.
|
| 141 |
|
| 142 |
-
---
|
| 143 |
|
| 144 |
-
## π License
|
| 145 |
-
MIT (or your choice). See `LICENSE`.
|
|
|
|
| 1 |
+
# ClaimCheck.AI β Agentic Fact Verification for Calls
|
| 2 |
|
| 3 |
**ClaimCheck.AI** is an agentic AI pipeline that turns meeting audio (Zoom/phone) into an evidence-backed report:
|
| 4 |
+
1) **ASR Agent** β transcript + timestamps
|
| 5 |
2) **Claim Extraction (watsonx.ai LLM)** β JSON claims
|
| 6 |
3) **Evidence Retrieval (watsonx.ai Embeddings + FAISS + optional Rerank)** β KB hits
|
| 7 |
4) **Verification (watsonx.ai LLM)** β supported/refuted/insufficient + citations
|
|
|
|
| 9 |
|
| 10 |
## β¨ Why it matters
|
| 11 |
High-stakes calls contain promises and metrics (SLA, compliance, finance). ClaimCheck.AI verifies statements against your **trusted KB** so decisions are grounded in factsβnot memory.
|
| 12 |
+
git branch -M main
|
| 13 |
---
|
| 14 |
|
| 15 |
## π§ Project structure
|
|
|
|
| 27 |
β β ββ json_utils.py # robust JSON extraction from LLM outputs
|
| 28 |
β ββ schemas/ # pydantic models (Claim, Evidence, Verdict, CallReport)
|
| 29 |
β ββ services/
|
| 30 |
+
β β ββ asr.py # Speech to Text model
|
| 31 |
β ββ main.py # FastAPI: /health, /process-audio, /process-transcript
|
| 32 |
ββ kb/
|
| 33 |
β ββ snippets.jsonl # your knowledge base (facts; one JSON per line)
|
|
|
|
| 117 |
|
| 118 |
## π§ How it works (agentic)
|
| 119 |
|
| 120 |
+
## π§ Core Concepts and Models
|
| 121 |
+
|
| 122 |
+
ClaimCheck.AI combines modern **agentic AI** orchestration with core NLP, IR, and speech processing techniques. Each agent is powered by a specific model or algorithm:
|
| 123 |
+
|
| 124 |
+
| Agent | Function | Model/Tool Used | Concepts |
|
| 125 |
+
|---------------|--------------------------------------|-----------------------------------------------|----------|
|
| 126 |
+
| ASR Agent | Audio transcription + timestamps | `IBM Speech-to-Text` or `Whisper` | Automatic Speech Recognition (ASR), Diarization |
|
| 127 |
+
| Claim Extractor | Turns transcript β atomic claims | `watsonx.ai` Prompt Lab + `granite-3-8b-instruct` | Information Extraction, Prompt Engineering |
|
| 128 |
+
| Retriever | Find matching KB facts | `granite-embedding-107m-multilingual`, FAISS, optional `slate-30m-rtrvr` | Embedding-based Retrieval, Vector Search, Reranking |
|
| 129 |
+
| Verifier | Evaluate support/refute status | `granite-3-8b-instruct` | Fact Verification, Retrieval-Augmented Generation (RAG) |
|
| 130 |
+
| Summarizer | Generate exec summary + action items | `granite-3-8b-instruct` | Abstractive Summarization, Plan Extraction |
|
| 131 |
+
|
| 132 |
|
| 133 |
---
|
| 134 |
|
|
|
|
| 145 |
- **OpenMP error (macOS)** β set `KMP_DUPLICATE_LIB_OK=TRUE` and `OMP_NUM_THREADS=1`.
|
| 146 |
- **JSON parse errors** β we use a robust extractor; check server logs `[RAW OUTPUT]`.
|
| 147 |
|
|
|
|
| 148 |
|
|
|
|
|
|