tools-only PDF Processing Troubleshooting
Common issues and solutions for PDF processing scripts.
Common issues
"Module not found" errors
pip install -r requirements.txt
Tesseract not found
# Install tesseract system package (see Dependencies in SKILL.md)
Memory errors with large PDFs
# Process page by page instead of loading entire PDF
with pdfplumber.open("large.pdf") as pdf:
for page in pdf.pages:
text = page.extract_text()
# Process page immediately
Permission errors
chmod +x scripts/*.py
Getting help
All scripts support --help:
python scripts/analyze_form.py --help
python scripts/extract_tables.py --help
For detailed documentation on specific topics, see:
- forms.md - Complete form processing guide
- tables.md - Advanced table extraction
- ocr.md - Scanned PDF processing
- workflows.md - Common workflows and best practices