aec-document-review

Document Review: an LLM agent that reviews architecture, engineering and construction (AEC) documents, as a Streamlit page. Upload drawings, specifications, submittals, reports or calculation packages; it reads the text, looks at the pages where the text is not the page (drawings, scans, tables drawn as lines), answers with the sheet or page it found each thing on, and hands back Word memos and marked-up copies of the PDF. A review aid: the judgement stays with the reviewer, and every markup it writes is signed as an AI draft.

It runs on two packages of the same project:

• aec-agent-core, the shared core (model connections, vision calls, guards and records, Word and Excel), pinned exactly;
• planlens, the document layer (page maps, located text, tables, review markups), pinned exactly.

It imports nothing geotechnical. The geotechnical agent it was split from, GeotechStaffEngineer, is a separate package.

Install

pip install aec-document-review
pip install "aec-document-review[azure]"   # Key Vault and certificate sign-in

Python 3.11 or later; it is tested on 3.11 and 3.12. A host behind a package mirror installs it from the mirror like any other package; a wheel installed by path works the same way.

Run

aec-document-review                       # streamlit run of the page
aec-document-review --server.port 8502    # further arguments go to Streamlit

or, in a host that starts Streamlit on a script of its own (an app.py of a few lines):

from aec_document_review.tinyapps_entry import main
main()

With no model configured the page starts and says so in a banner.

Settings

Read from the environment, then from an Azure Key Vault (when KV_NAME names one and the host has a managed identity), then from a .env file in the working folder.

The settings keep the GEOTECH_ names the page had before the split, so a deployment carries on unchanged.

The project's deployment notes are in its repository: tinyapps/TINYAPPS.md and the wrapper template tinyapps/wrapper_repo/.

The review suite

The 38 review tasks the page is measured on, with deterministic checks, run through the core's suite framework on this page:

from aec_document_review.review_eval import score_review_suite
score_review_suite(model, out_dir="review_eval_run", docs_dir="docs",
                   dry_run=True)   # lists the tasks and checks the documents

Licence

MIT. See LICENSE.