Repository navigation
hole-docs v0.1.0
Free PDF tools for transparency workflows
Making public records accessible without expensive software
Mission
Access to public records shouldn't require subscriptions or expensive tools.
hole-docs provides professional PDF capabilities - completely free and open source.
Built by The HOLE Foundation for transparency advocates everywhere.
Downloads
Choose your platform:
macOS:
- Apple Silicon (M1/M2/M3):
hole-docs-v0.1.0-macos-arm64.tar.gz - Intel:
hole-docs-v0.1.0-macos-amd64.tar.gz
Linux:
- AMD64 (Ubuntu/Debian):
hole-docs-v0.1.0-linux-amd64.tar.gz - ARM64 (Raspberry Pi):
hole-docs-v0.1.0-linux-arm64.tar.gz
Installation
# Download (choose your platform)
curl -LO https://github.com/The-HOLE-Foundation/hole-docs/releases/download/v0.1.0/hole-docs-v0.1.0-linux-amd64.tar.gz
# Extract
tar -xzf hole-docs-v0.1.0-linux-amd64.tar.gz
# Install
sudo mv hole-docs /usr/local/bin/
# Verify
hole-docs helpFeatures
✅ Merge PDFs - Combine FOIA responses, consolidate records
✅ Split PDFs - Extract relevant pages, separate documents
✅ Render to Images - Convert for analysis, archiving, evidence
✅ Optimize - Reduce file sizes for sharing
✅ Extract Annotations - Pull reviewer comments and highlights
✅ MCP Server - AI assistant integration
✅ Free Forever - No subscriptions, no fees
Quick Examples
# Merge FOIA responses
hole-docs merge complete.pdf agency1.pdf agency2.pdf
# Render for analysis
hole-docs render disclosure.pdf ./photos/
# Extract reviewer comments
hole-docs annotations reviewed-draft.pdf
# Start MCP server for AI assistants
hole-docs serve --httpRequirements
System dependencies (install via package manager):
# macOS
brew install qpdf mupdf ghostscript
# Ubuntu/Debian
sudo apt install qpdf mupdf-tools ghostscriptNo other dependencies required - static binary, runs anywhere.
Documentation
Replaces expensive tools like Adobe Acrobat ($240/year) with free, open-source alternative.
Built with ❤️ by The HOLE Foundation