Metadata-Version: 2.4
Name: pdf-reader-0jsfjf
Version: 0.1.0
Summary: PDF OCR, indexing and search tools for AI assistants
License: Proprietary
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.12
Requires-Dist: aiohttp>=3.14.5
Requires-Dist: fastapi
Requires-Dist: fastmcp<4,>=3.4.11
Requires-Dist: lm-deluge
Requires-Dist: pdf2image
Requires-Dist: pillow>=13.0.0
Requires-Dist: pydantic
Requires-Dist: pypdf>=6.21.2
Requires-Dist: python-dotenv
Requires-Dist: requests
Requires-Dist: tantivy
Requires-Dist: tesserocr
Description-Content-Type: text/markdown

# PDF Reader

A hybrid PDF indexing and search system designed for AI assistant integration via MCP (Model Context Protocol). Rather than dumping entire PDF content into context windows, this tool provides intelligent document processing, full-text search, and optimized image handling.

## Features

- **Hybrid Processing**: Local (tesserocr) and remote (Modal cloud) OCR processing
- **Smart Search**: Tantivy-based full-text search with BM25 ranking and query escaping
- **AI Enhancement**: LLM-generated document titles and page summaries  
- **Provider Optimization**: Automatic image resizing for OpenAI/Anthropic API limits
- **MCP Integration**: RESTful API for seamless AI assistant integration

## Quick Start

```bash
# Activate virtual environment
source .venv/bin/activate

# Example usage (if you have an existing index)
python -c "
from pdf_reader.index import PDFIndex
index = PDFIndex.load('indexes/index2')
results = index.search_pages(['your search term'])
print(f'Found {len(results)} results')
"
```

## Architecture

The system uses a hybrid approach:
- **Tantivy**: Fast full-text search across OCR text and AI summaries
- **SQLite**: Blob storage for complete page data (text + images)
- **AI Enhancement**: Document titles and page summaries via LLM
- **Provider-Aware Images**: Optimized for different LLM API requirements

## MCP Tools

- `list_pdfs`: List available PDF documents
- `search_pdfs`: Keyword search across all documents  
- `read_pdf`: Read specific pages from a document
- `read_pdfs`: Bulk read across multiple documents

## Development

See `CLAUDE.md` for detailed architecture documentation, development guidelines, and troubleshooting information.
