Setup & Installation

clawhub install liteparse

Or with OpenClaw CLI:

openclaw skills install liteparse

What This Skill Does

LiteParse is a Documents & Knowledge skill that parse, extract text from, and screenshot PDF and document files locally using the LiteParse CLI (`lit`). Use when asked to extract text from a PDF, parse a Word/Excel/PowerPoint file, batch-process a folder of documents, or generate page screenshots for LLM vision workflows. Runs entirely offline — no cloud, no API key. Supports PDF, DOCX, XLSX, PPTX, images (jpg/png/webp), and more. Triggers on phrases like "extract text from this PDF", "parse this document", "get the text out of", "screenshot this PDF page", or any request to read/extract content from a file..

LiteParse

Local document parser built on PDF.js + Tesseract.js. Zero cloud dependencies.

Binary: lit (installed globally via npm) Docs: https://developers.llamaindex.ai/liteparse/

Quick Reference

# Parse a PDF to text (stdout)
lit parse document.pdf

# Parse to file
lit parse document.pdf -o output.txt

# Parse to JSON (includes bounding boxes)
lit parse document.pdf --format json -o output.json

# Specific pages only
lit parse document.pdf --target-pages "1-5,10,15-20"

# No OCR (faster, text-layer PDFs only)
lit parse document.pdf --no-ocr

# Batch parse a directory
lit batch-parse ./input-dir ./output-dir

# Screenshot pages (for vision model input)
lit screenshot document.pdf -o ./screenshots
lit screenshot document.pdf --target-pages "1,3,5" --dpi 300 -o ./screenshots

Output Formats

Format Use case
text (default) Plain text extraction, feeding into prompts
json Structured output with bounding boxes, useful for layout-aware tasks

OCR Behavior

  • OCR is on by default via Tesseract.js (downloads ~10MB English data on first run)
  • First run will be slow; subsequent runs use cached data
  • --no-ocr for pure text-layer PDFs (faster, no network needed)
  • For multi-language: --ocr-language fra+eng

Supported File Types

Works natively: PDF

Requires LibreOffice (brew install --cask libreoffice): .docx, .doc, .xlsx, .xls, .pptx, .ppt, .odt, .csv

Requires ImageMagick (brew install imagemagick): .jpg, .png, .gif, .bmp, .tiff, .webp

Installation Notes

  • Installed via npm: npm install -g @llamaindex/liteparse
  • Brew formula exists (brew tap run-llama/liteparse) but requires current macOS CLT — use npm as primary install path on this machine
  • Binary path: /opt/homebrew/bin/lit

Workflow Tips

  • For VA forms, job description PDFs, military docs: lit parse file.pdf -o /tmp/output.txt then read into context
  • For scanned PDFs (no text layer): OCR is required; complex layouts may degrade — consider LlamaParse cloud for critical docs
  • For vision model workflows: use lit screenshot to generate page images, then pass to image tool or similar
  • For batch jobs: use lit batch-parse — it reuses the PDF engine across files for efficiency

Limitations

  • Complex tables, multi-column layouts, and scanned government forms may produce imperfect output
  • LlamaParse (cloud) handles the hard cases: https://cloud.llamaindex.ai
  • Max recommended DPI for screenshots: 300 (higher = slower, larger files)

Reference

See references/output-examples.md for sample JSON/text output structure.

Version History

Latest version: 1.0.0

First published: Mar 21, 2026. Last updated: Mar 21, 2026.

1 version released.

Frequently Asked Questions

Is LiteParse free to use?
Yes. LiteParse is a free, open-source skill available on the OpenClaw Skills Registry.
What platforms does LiteParse support?
It runs on any platform that supports OpenClaw, including macOS, Linux, and Windows.