Document Intelligence

Read the bundled business documents, classify them, extract structured fields, reconcile invoice lines, and publish a checked report. Every stage performs local data processing and passes its files to the next activity.

Run locally

Requires Go and Python 3.12+. Blender Render Farm also requires Docker. Run from a fresh checkout:

git clone https://github.com/UFFeScience/akoflow-examples.git
cd akoflow-examples/document-ai/document-intelligence
./prepare.sh && ./run.sh

Preparation downloads the Go YAML module. Results are in outputs/manifest.json, outputs/dag-validation.json, and outputs/stage-<activity>.json. Independent branches run concurrently as soon as their own dependencies and a local execution slot are available.

Inspect the same DAG in Desktop

Start the local AkôFlow daemon with Docker available and configure AKOFLOW_API_TOKEN in your shell. From this example directory:

go run ../../tools/daemon-local -root ../.. -example document-ai/document-intelligence

The command builds the declared image, validates Docker connectivity, registers local-only infrastructure, and executes the workflow through the daemon. Current verified screenshots are in screenshots/current/; their manifest identifies the exact run and image. The full daemon projection is in evidence/daemon-run.json.

Public Hub version and measured execution

Open this workflow and its results · Documentation

Import into AkôFlow Desktop

Create workflow → Import from Hub → paste this immutable URI:

akoflow://hub/publications/85d4152f-da21-4d6b-84d0-6cc937d8b96e/versions/1

The URI imports the workflow definition. Build or pull the public image and register the companion environment.yaml, scope.yaml, and topology.yaml from this source bundle before planning a local execution. No hosted account, GPU or cloud capacity is required for this CPU profile.

Image: ghcr.io/uffescience/akoflow-examples/document-intelligence@sha256:6740ce1e600d1961a24cf8558cc68ca6bd064b69537fcd486ffabd76f7dc4950.

Actual homeserver results

Run hubv1-document-intelligence-local-65cf94270e-run-20261115t055504.134836957 completed 5/5 activities in 10.75977373123169 seconds. These are measured Docker-backed computations, not simulated timing. The captured manual plan uses placeholder predicted timings; those predictions are not benchmark measurements. Use the observed execution metrics for performance analysis. Cost is the configured local compute cost and excludes electricity and hardware.

Download the native experiment capture. The Hub Results tab includes the same plan, attempts, metrics and logs.

Inputs and outputs

Input fixtures and their generation code are in this bundle's data/ and scripts/ directories; inspect them together with the workflow definition and bundle configuration for profile assumptions. Fixtures are generated by the included code unless a bundle identifies an upstream dataset. No repository-wide LICENSE file is currently present: inspect the bundle and upstream terms before redistributing source or data; publication here does not grant additional rights. Outputs expected from this workflow:

• ingested.json
• classified.json
• extracted.json
• reconciliation.json
• invoice-summary.csv
• report.json

Download the actual validated output files.

Illustrated walkthrough

The following reference screenshots come from the documentation walkthrough. The current measured run is recorded separately above.

classify

extract

ingest

reconcile

report

workflow