Akshara Vision — Restore. Read. Preserve.
← Prev<br>1 / 7
Next →
akshara-vision<br>terminal document orchestration
akv --version 1.0.0
/ \ | |/ // ___|| | | | / \ | _ \ / \<br>/ _ \ | ' / \___ \| |_| | / _ \ | |_) | / _ \<br>/ ___ \| . \ ___) | _ |/ ___ \| _
A local-first, vendor-agnostic document intelligence CLI & grounded chat workbench
View Repository on GitHub
akshara-vision<br>Slide 1
01 / The Context<br>The Problem Space
The Disconnection<br>Why raw model outputs fall short in document digitization.
Vision language models and LLMs are excellent at OCR correction and translation, but integrating them directly into bulk archival pipelines fails on practical execution.
Workflows are fragile. A network drop can ruin a multi-hour book extraction, dense scans trigger context truncation, and models ignore layout structural metadata entirely.
Ad-Hoc Model Calls<br>Akshara Vision Engine
Fragile Pipelines<br>API failures or terminal exits abort progress; no state preservation.
Resumable Stages<br>Continuous page checkpoints guarantee no data loss on interruption.
Raw Text Clutter<br>Extracts plain strings without layout tags, figures, or roles.
Structure Normalization<br>Builds normalized layout trees mapping columns, headers, and figures.
Vendor Lock-in<br>Hardcoded connections restrict migration between platforms.
Model-Agnostic Routing<br>Uniform routing across local GGUF offline engines or cloud APIs.
akshara-vision<br>Slide 2
02 / Document Intelligence<br>Layout Normalization
Semantic Structure Trees<br>Akshara Vision does not treat scans as plain text blocks.
Every page is parsed hierarchically, extracting reading orders, column estimates, local geometry, and semantic document roles.
Execution Modes & Tradeoffs
Quality<br>Full pipeline: local layout parse + block-guided LLM restoration + vision crop verification. Best accuracy for damaged pages.
Balanced<br>Saves time: local layout parse + direct block-guided text restoration. Skips costly iterative layout reviews.
Fast<br>Max speed: bypasses block mapping, visual segment prompting, role classification, and crops. Fast pure text extraction.
Stage 1
Local Page Segmentation<br>Detects page geometry (columns, coordinates) using local engine backends.
Stage 2
Reading Order Sort<br>Orders blocks sequentially to prevent text column mixing.
Stage 3
Block-Guided LLM Restoration<br>Reconstructs damaged text segment-by-segment using [BLOCK x] tags.
Stage 4
Extraction & Exporters<br>Parses CSV tables, crops visual figures, and generates MD/DOCX/EPUB/PDF.
akshara-vision<br>Slide 3
03 / Grounded Chat<br>Conversational Review
Interactive Verification<br>Grounded Q&A over run manifests and raw layout files.
Ask questions directly over processed run directories. All answers are strictly grounded in indexed source text chunks, maintaining absolute audit trails.
Vision Mode Support<br>Supports direct discussions over raw images (signboards, charts, tables) or page-specific queries inside PDFs without full corpus pre-indexing.
Dynamic Re-querying<br>Re-opens and queries the source visual image directly if the indexed OCR text is incomplete or ambiguous.
Local Diagnostic Commands<br>Index search using terminal shortcuts: `/sources` to list segments, `/find` to search keywords, and `/open` to view specific chunks offline.
akv chat --session S1
$ akv chat examples/sample.txt<br>[i] Running grounded chat over examples/sample.txt<br>[i] Type /exit or Ctrl+D to end.
akv chat › /find land grant<br>[i] Found 2 matches in sources:<br>* Page 3 (Paragraph block 1)<br>* Page 7 (Footnote block 4)
akv chat › What year was the land grant executed?<br>The land grant was executed in 1823 during the reign of Serfoji II (Page 3).
akshara-vision<br>Slide 4
04 / Auditing<br>Visual Layout Review
Human-In-The-Loop Validation<br>Auditing layout nodes, block confidence, and figure crops.
Run folders can be reviewed visually inside the terminal or compared side-by-side inside a browser to verify rendering and layout composition.
Terminal Preview<br>Visual Block-Map
Plots text columns and figure regions directly in a terminal-native layout preview screen before generating exports.
Browser Reports<br>Comparison Views
`akv compare` compiles a side-by-side visual report of raw pages and restored text to review image crops and layout flow.
Asset Control<br>Review Markdown
Saves a readable `layout_review.md` in the run directory. Delete incorrect figure crop assets locally to skip them automatically.
akshara-vision<br>Slide 5
05 / Capabilities<br>Feature Overview
Key Architectural Strengths<br>A production-ready framework for digital preservation.
Model Routing<br>Backend Agnostic
Routes queries transparently. Run offline local models (Ollama, LM Studio, Jan, llama.cpp) for privacy and zero cost, or scale out to cloud APIs (Gemini, OpenRouter, Anthropic).
Local GGUF<br>Cloud APIs
Resumable Runs<br>Fault-Tolerant Stages
Writes page/chunk stage checkpoints. Interruptions (Ctrl+C, network crash) do not force re-processing. Simply run resume to recover completed pages and compile...