jbarrow/commonforms

CommonForms — open models to auto-detect PDF form fields

What's novel

CommonForms — open models to auto-detect PDF form fields

Code Analysis

9 files read · 3 rounds

Uses object detection models (YOLO/RF-DETR) to identify form fields in PDF documents and converts them into fillable PDF form annotations (text boxes, checkboxes, signatures) with proper coordinate transformation and reading-order sorting.

Strengths

Clean separation of concerns with non-trivial PDF annotation internals (direct AcroForm/Widget manipulation, coordinate system conversion), clever heuristics for signature field promotion via text proximity scoring, and a complete ML pipeline from dataset generation to inference with multiple model backends.

Weaknesses

Limited test coverage (no unit tests for form_creator or coordinate transformation), a hardcoded image_size bug in FFDetrDetector, and the signature promotion logic only handles one widget per page rather than all matching rows.

Score Breakdown

Innovation

6 (25%)

Craft

72 (35%)

Traction

77 (15%)

Scope

70 (25%)

Signal breakdown

Innovation

Not Fork+1

Code Novelty+1

Concept Novelty+3

Craft

Ci+5

Tests+5

Polish+0

Releases+4

Has License+0

Code Quality+22

Readme Quality+15

Recent Activity+7

Structure Quality+5

Commit Consistency+4

Has Dependency Mgmt+5

Traction

Forks+20

Stars+30

Hn Points+8

Watchers+10

Early Traction+5

Devto Reactions+0

Community Contribs+4

Scope

Commits+7

Languages+3

Subsystems+10

Bloat Penalty+0

Completeness+6

Contributors+7

Authored Files+8

Readme Code Match+3

Architecture Depth+5

Implementation Depth+8

Evidence

Commits

Contributors

Files

Active weeks

TestsCI/CDREADMELicenseContributing

Repository

Language

Python

Stars

968

Forks

131

License

—