hole-docs v0.1.0

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 help

Features

✅ 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 --http

Requirements

System dependencies (install via package manager):

# macOS
brew install qpdf mupdf ghostscript

# Ubuntu/Debian
sudo apt install qpdf mupdf-tools ghostscript

No other dependencies required - static binary, runs anywhere.

Documentation

• Installation Guide
• Architecture
• Full Documentation

---

Replaces expensive tools like Adobe Acrobat ($240/year) with free, open-source alternative.

Built with ❤️ by The HOLE Foundation