SubScribe Field OS: A Local-First Voice OS for Construction Paperwork
Description and use
SubScribe Field OS is a local, voice‑controlled system that lets construction subcontractors generate signed PDFs for change orders, daily logs, and delay notices offline, improving documentation speed and accuracy.
Problem
Small trade subcontractors lose thousands of dollars annually because out-of-scope work rarely gets documented on time, and manual paperwork is impractical on noisy job sites.
Outcome
A solo contractor used SubScribe on a laptop to dictate daily logs and change orders, instantly producing polished, legal‑ready PDFs without keyboard input, leading to a willingness to pay $5–$10/month.
Workflow
- 1. User speaks a single sentence describing work performed.
- 2. Local audio transcription (faster‑whisper int8) converts speech to text with trade‑vocabulary prompt.
- 3. Transcript routed to Gemma 2B via Ollama with temperature 0.0 and JSON format; Pydantic schemas validate output.
- 4. If mismatch, orchestrator retries until valid JSON is produced.
- 5. Offline contract RAG (ChromaDB) retrieves relevant clauses from local PDF of scope agreement and supplies them to Gemma for citation.
- 6. Final JSON is serialized and written to local SQLite audit trail.
- 7. Jinja2 template populates PDF layout; WeasyPrint renders PDF in <2 s.
- 8. User reviews parsed JSON and exports PDF via Streamlit/Gradio UI; FastAPI dashboard allows off‑site managers to view history.
Evidence
SubScribe Field OS is a local-first, voice-controlled operating system engineered to automate construction field documentation entirely offline.
On loud, chaotic job sites, tradespeople can speak a single sentence and instantly generate a signed, print-ready change order, daily log, or delay notice.
The entire application runs locally on a standard laptop with zero API keys or per-document processing fees.
The system was put to the test by a solo contractor running SubScribe directly on a laptop. By simply dictating daily logs and change orders aloud, he was able to instantly compile polished, legal-ready PDFs without touching a keyboard.
- Record date: 2026-10-19T21:41:21.008Z