extractforms 0.1.0

A python project to turn scanned forms into a list of key-value pairs.

ExtractForms

extractforms is a Python package and CLI to extract key/value fields from PDF forms.

Quickstart

uv sync --group dev
uv run pre-commit install
uv run ruff format .
uv run ruff check .
uv run ty check src tests
uv run pytest
uv run pre-commit run --all-files

CLI

extractforms extract --input form.pdf --output results/result.json --passes 2

Supported options include:

• --no-cache
• --dpi, --image-format, --page-start, --page-end, --max-pages
• --chunk-pages
• --extra-instructions
• --schema-id, --schema-path, --match-schema

Environment

Copy .env.template to .env and configure:

• logging (LOG_LEVEL, LOG_JSON, LOG_FILE)
• enterprise network/TLS (HTTP_PROXY, HTTPS_PROXY, ALL_PROXY, NO_PROXY, CERT_PATH)
• model endpoint (OPENAI_BASE_URL, OPENAI_API_KEY, OPENAI_MODEL)

Project Layout

• src/extractforms: package code
• tests/unit: fast default tests
• tests/integration: component-level tests
• tests/end2end: user-facing behavior tests
• skills: AI helper skills for coding workflows

Release

1. Bump version in pyproject.toml.
2. Create and push a git tag: vX.Y.Z.
3. GitHub Action publishes to PyPI.

For manual validation, use workflow dispatch with publish_target=testpypi.