tamr-plus-lite 0.1.0

TAMR+ Lite — Open-core Trust-Augmented Multi-phase Retrieval framework for EU AI Act compliant AI applications

TAMR+ Lite

Trust-Augmented Multi-phase Retrieval — Open-Core Edition

The open-source core of the TAMR+ framework, providing EU AI Act-compliant scoring, gap attribution, and retrieval primitives for building trustworthy AI applications.

Three-Stage Architecture

1. Document Manifest Selector — 5-signal deterministic pre-filtering (zero LLM calls)
2. Multi-Phase Retrieval — Vector ANN, KG alignment, causal density, diversity selection
3. TRACE Scoring — 5-dimension formula-based scoring with gap attribution

Installation

pip install tamr-plus-lite

Quick Start

from tamr_plus_lite import build_trace_scores, compute_gap_attribution

# Score a response
score = build_trace_scores(
    source_count=5,
    total_claims=10,
    cited_claims=8,
    evidence_strength=0.8,
)
print(f"TRACE Score: {score.overall:.0%}")
print(score.explanation)

# Explain gaps
gap = compute_gap_attribution(
    trace_score=score.overall,
    source_count=5,
    total_claims=10,
    cited_claims=8,
)
print(gap.explanation)
for component in gap.components:
    print(f"  {component.friendly_name}: {component.value:.1%} — {component.action}")

Modules

Module	Description
tamr_plus_lite.scoring	TRACE 5-dimension scoring engine
tamr_plus_lite.gap	Gap attribution ("Why not 100%?")
tamr_plus_lite.manifest	Document manifest selector (Stage 1)
tamr_plus_lite.classifier	Zero-LLM query classifier
tamr_plus_lite.interfaces	Abstract interfaces for pluggable backends
tamr_plus_lite.extraction	KG extraction prompt + utilities
tamr_plus_lite.chunking	Text chunking + JSON repair
tamr_plus_lite.profiles	Domain scoring profiles

EU AI Act Compliance

All scoring is formula-based (not ML) for full transparency:

• Art. 13: Every parameter is explicit and auditable
• Art. 14: Every score decomposes into human-readable factors
• Art. 15: Deterministic formulas guarantee reproducibility

TRACE Dimensions

Dimension	Weight	What It Measures
T — Transparency	25%	Source attribution and model identification
R — Reasoning	20%	Evidence basis and cross-document connections
A — Auditability	20%	Audit trail completeness
C — Compliance	20%	Regulatory framework alignment
E — Explainability	15%	Response structure quality

Gap Attribution Taxonomy

Code	Friendly Name	Description
SCG	Document Coverage	How much is backed by uploaded documents
PKC	AI Knowledge Used	Reliance on AI training data
DLT	Specialized Vocabulary	Domain terminology precision
ADG	Citation Coverage	Citation completeness
FSC	System Limitation	Irreducible 3% structural ceiling

Full TAMR+

This is the open-core edition. The full TAMR+ SDK includes:

• Premium 7-phase retrieval pipeline (HDI, governance, compliance certificates)
• Gamified insights engine
• Production domain profiles with calibrated weights

Contact: [e-mail]

License

Apache-2.0 — Quantamix Solutions B.V.

Patent: EP26162901.8 (TAMR+ Three-Stage Architecture)