localparse 0.1.0

Official Python client for the LocalParse document-parsing API (LlamaParse-compatible).

LocalParse — Python client

Official Python client for the LocalParse document-parsing API. LocalParse is a drop-in LlamaParse-compatible parser with a deterministic accuracy layer: table-detection recovery (catches tables a layout model misses) and oracle-free financial-identity checks (flags Totals that don't reconcile).

Install

pip install localparse

Quickstart

from localparse import LocalParse

client = LocalParse(api_key="lp-...")          # or set LOCALPARSE_API_KEY

result = client.parse("invoice.pdf", result_type="markdown")
print(result.markdown)

# Accuracy signal that plain OCR/LLM parsers don't give you:
print(result.identity_check)     # {tables_checked, violations, ...} or None
print(result.recovered_tables)   # tables recovered by detect_repair

Fetch JSON or the ingestion-ready structured contract instead:

result = client.parse("10k.pdf", result_type="json")
for page in result.pages:
    ...

structured = client.parse("10k.pdf", result_type="structured")

Persist a whole folder (incremental)

Ingest a data room into a named case; re-runs only parse new/changed files (unchanged files are skipped by content hash):

results = client.parse_folder(
    "./data-room",
    case_id="acme",
    resume=True,
    on_progress=lambda path, res: print("parsed" if res else "skipped", path),
)

Full control (async jobs)

job = client.upload("big.pdf", result_type="json", case_id="acme")
job = client.wait(job.id)
if job.is_success:
    result = client.get_result(job.id, "json")

Configuration

Argument	Default	Meaning
api_key	LOCALPARSE_API_KEY env	Bearer token for the API.
base_url	https://api.localparse.com	Point at a self-hosted instance if needed.
timeout	60	Per-request HTTP timeout (seconds).
poll_interval	2.0	Seconds between status polls in parse/wait.
max_wait	900	Max seconds to wait for a job before JobTimeoutError.

Errors

AuthenticationError (401/403), QuotaExceededError (402), NotFoundError (404), RateLimitError (429, with .retry_after), APIError (other non-2xx), JobFailedError (job ended ERROR/CANCELED), JobTimeoutError — all subclass LocalParseError.