BUILD RECORD

aiPDF Engine

A document job became a sequence of retryable steps, so one bad page did not take down the whole run.

PRODUCT BUILD

A long document job can die on one bad page, hours in.

document pipelines job orchestration OCR retired

One job per step, with retries behind each.

PROJECT

aiPDF Engine

STATUS

Retired

WHAT IT IS

A serverless pipeline for large document sets. A router took the upload and the request, a planner ordered the jobs, and a queue carried them.

IMPACT

A long job survived its worst page: one bad scan retried on its own instead of killing the run.

SCOPE

Whole documents split into jobs rather than one prompt per file. Three workers, one job each.

STACK

FastAPI planner queue dead-letter queue

MY ROLE

Architecture, planner, workers, infrastructure, open-source release.

VERIFIED

Open source, built and released solo. One file deployed the whole stack. It ran end to end against a local AWS stand-in.

THE METHOD

How one request ran, start to finish

A typical request: "Clean up this scanned packet."

a document request · upload to specialist
took · planned · queued · ran

01 Took the upload and the request

A FastAPI router caught both.

02 Planned the chain

It planned which workers ran, and in what order.

03 Queued every step

One job ran per step and retried on its own if it failed.

04 Ran the specialist

It split, merged, and rotated the documents, ran OCR, then compressed and repaired them.

LIMITS STAY ATTACHED

What it refused to do

The planner only ordered operations the workers implemented.

A job that kept failing landed in a dead-letter queue.

Quotas were tracked, so one job could not hog the queue.

RECORD AND LINEAGE

Where it went

SIBLING BUILD

PagePurger, the same pipeline pointed at medical-legal record review.

WHAT TRANSFERS

Let the model order the jobs. Split, OCR, and compress stay code.

Back to Side Projects → Read the PagePurger build →

THE ARCHITECTURE

Architecture map of AiPDF Engine: the real components and how they connect
THE ARCHITECTURE MAP

A RELATED PROBLEM

Does one bad page still break a long document job?

This build is retired, but durable document work is still hard. If the failure boundary is costing you time, I would like to see it.

Email me →