Metadata-Version: 2.4
Name: pgrag-eval-lite
Version: 0.2.1
Summary: Local-First RAG Retrieval, Chunking & pgvector Diagnostic Workbench (CLI)
Author: Muhammad Talha
License: MIT
Project-URL: Homepage, https://mtalha5.gumroad.com/l/pgrag-inspector?utm_source=pypi&utm_medium=homepage
Project-URL: Pro Visual Studio, https://mtalha5.gumroad.com/l/pgrag-inspector?utm_source=pypi&utm_medium=sidebar
Project-URL: Download, https://mtalha5.gumroad.com/l/pgrag-inspector?utm_source=pypi&utm_medium=download
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: pydantic>=2.10.0
Requires-Dist: polars>=1.18.0
Requires-Dist: numpy>=2.1.0
Requires-Dist: rich>=13.9.4
Requires-Dist: typer>=0.15.1
Requires-Dist: sqlalchemy>=2.0.36
Requires-Dist: pgvector>=0.3.6
Provides-Extra: dev
Requires-Dist: pytest>=8.3.0; extra == "dev"
Provides-Extra: postgres
Requires-Dist: asyncpg>=0.30.0; extra == "postgres"

# pgRAG-Inspector (pgrag-eval-lite & Pro Visual Studio)

Local-First RAG Retrieval, Chunking & pgvector 0.8+ Diagnostic Workbench ($0.00 LLM API Cost).

👉 **[Download pgRAG-Inspector Pro (4-Page Visual Workbench + 1-Click SQLAlchemy 2.0 / Alembic / Pytest Exporter) or the Free Lite Bundle on Gumroad](https://mtalha5.gumroad.com/l/pgrag-inspector?utm_source=pypi&utm_medium=readme_top)**

## Quickstart (CLI)

    pip install pgrag-eval-lite
    pgrag init-samples
    pgrag check --chunks examples/sample_chunks.json --golden examples/sample_golden_qa.json --fail-under-recall5 95

## What It Diagnoses Locally

1. **Pre-Index Chunk & Markdown Table Health Scanner:** Deterministically flags sliced Markdown/PDF tables (BROKEN_MARKDOWN_TABLE), >80% sliding-window token overlap, and mid-sentence cutoffs before indexing.
2. **Multi-Strategy Polars/NumPy IR Sweep ($0.00 API Cost):** Benchmarks Pure Dense (pgvector <=>), Pure Sparse FTS (ts_rank_cd), and Hybrid RRF across Exact SKUs/Error Codes, Financial Tables, and Semantic Paraphrases.
3. **pgRAG-Inspector Pro Visual Studio (127.0.0.1:8787):** Side-by-side 3-strategy chunk diffing (Docling HybridChunker), interactive RRF rank profiler, and 1-click code generation for async SQLAlchemy 2.0, Alembic (hnsw + tsvector GIN + SET LOCAL hnsw.iterative_scan = 'relaxed_order'), and Pytest CI gates.

🔗 **Get the Full Visual Workbench:** [https://mtalha5.gumroad.com/l/pgrag-inspector](https://mtalha5.gumroad.com/l/pgrag-inspector?utm_source=pypi&utm_medium=readme_bottom)
