visual-parser 2.0.2__tar.gz → 2.0.4__tar.gz

{visual_parser-2.0.2 → visual_parser-2.0.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: visual-parser
-Version: 2.0.2
+Version: 2.0.4
 Summary: Standalone Visual-RAG PDF Parser - text extraction and Vision-LLM figure descriptions to JSONL
 Author: Zavier N. Ndum
 Author-email: zavier.ndum@tamu.edu
@@ -43,7 +43,6 @@ Requires-Dist: mypy; extra == "dev"
 
 # visual-parser (Standalone Visual-RAG PDF Ingestion)
 
-<!-- ![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg) -->
 ![Python 3.12.10](https://img.shields.io/badge/Python-3.12.10-brightgreen.svg)
 <!-- ![PyTorch](https://img.shields.io/badge/PyTorch-2.0%2B-ee4c2c.svg) -->
 
@@ -75,15 +74,16 @@ Prebuilt images are on **[zev94/radiant-llm](https://hub.docker.com/r/zev94/radi
 
 | Tag | Description |
 |-----|-------------|
-| `visual-parser-2.0` | Pinned release (v2.0) |
-| `visual-parser-latest` | Latest visual-parser build |
+| `visual-parser-latest` | Always latest build (rolling) |
+| `visual-parser-2.0.0` | Pinned release (Apache 2.0 release) |
+| `visual-parser-1.0` | Legacy — v1.0.0, stale |
 
 ### 1) Install Docker
 - Docker Desktop (Windows/macOS) or Docker Engine (Linux)
 
 ### 2) Pull the image
 ```bash
-docker pull zev94/radiant-llm:visual-parser-2.0
+docker pull zev94/radiant-llm:visual-parser-latest
 ```
 
 ### 3) Run (input + output on the same mounted folder)
@@ -91,7 +91,7 @@ Windows PowerShell:
 ```powershell
 docker run --rm --env-file .env `
   -v "C:\path\to\pdfs:/data" `
-  zev94/radiant-llm:visual-parser-2.0 `
+  zev94/radiant-llm:visual-parser-latest `
   --input-dir /data --output-dir /data
 ```
 
@@ -99,7 +99,7 @@ Linux / WSL:
 ```bash
 docker run --rm --env-file .env \
   -v "/path/to/pdfs:/data" \
-  zev94/radiant-llm:visual-parser-2.0 \
+  zev94/radiant-llm:visual-parser-latest \
   --input-dir /data --output-dir /data
 ```
 
@@ -109,7 +109,7 @@ Windows PowerShell:
 docker run --rm --env-file .env `
   -v "C:\path\to\pdfs:/data" `
   -v "C:\path\to\out:/out" `
-  zev94/radiant-llm:visual-parser-2.0 `
+  zev94/radiant-llm:visual-parser-latest `
   --input-dir /data --output-dir /out
 ```
 
@@ -122,11 +122,11 @@ docker images   # use the tag printed by Docker
 
 ### Model overrides (optional)
 
-Default vision model is **GPT-5.5** when using `--vision-provider gpt`. Override on the command line:
+Default vision model is **GPT-5.4** when using `--vision-provider gpt`. Override on the command line:
 
 ```powershell
 docker run --rm --env-file .env -v "C:\path\to\pdfs:/data" `
-  zev94/radiant-llm:visual-parser-2.0 `
+  zev94/radiant-llm:visual-parser-latest `
   --input-dir /data --output-dir /data --vision-model gpt-5.4
 ```
 
@@ -142,7 +142,7 @@ python visual-parser.py --input-dir "C:\path\to\pdfs"
 After pulling the image, run:
 
 ```bash
-docker run --rm zev94/radiant-llm:visual-parser-2.0 --help
+docker run --rm zev94/radiant-llm:visual-parser-latest --help
 ```
 
 For copy-paste **Docker** examples (vision presets, text modes, workers, rebuild), see [`docker-usage-examples.md`](docker-usage-examples.md).
@@ -173,23 +173,28 @@ Performance / misc:
 
 ## Citation
 
-If you use RADIANT-LLM or the accompanying evaluation materials, please cite the preprint:
+If you use RADIANT-LLM or the accompanying evaluation materials, please cite the journal article:
 
 ```bibtex
-@article{ndum2026radiant,
-  title={RADIANT-LLM: an Agentic Retrieval Augmented Generation Framework for Reliable Decision Support in Safety-Critical Nuclear Engineering},
+@article{ndum2026retrieval,
+  title={A retrieval-augmented, domain-intelligent agentic framework for reliable decision support in safety-critical nuclear engineering},
   author={Ndum, Zavier Ndum and Tao, Jian and Ford, John and Yim, Mansung and Liu, Yang},
-  journal={arXiv preprint arXiv:2604.22755},
-  year={2026}
+  journal={Reliability Engineering \& System Safety},
+  pages={113057},
+  year={2026},
+  publisher={Elsevier}
 }
 ```
 
+Journal: *Reliability Engineering & System Safety* (2026), article 113057  
 Preprint: https://arxiv.org/abs/2604.22755
 
 ---
 
 ## License
 
-This repository is currently proprietary and not licensed for public use, redistribution, or modification. Licensing terms will be updated after institutional review.
+Copyright 2026 Zavier N. Ndum
+
+This project is licensed under the Apache License 2.0. See the [LICENSE](https://github.com/SmartLabNuclear/RADIANT_LLM/blob/main/LICENSE) file in the RADIANT_LLM repository for the full license text.
 
 

{visual_parser-2.0.2 → visual_parser-2.0.4}/README.md

@@ -1,152 +1,157 @@
-# visual-parser (Standalone Visual-RAG PDF Ingestion)
-
-<!-- ![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg) -->
-![Python 3.12.10](https://img.shields.io/badge/Python-3.12.10-brightgreen.svg)
-<!-- ![PyTorch](https://img.shields.io/badge/PyTorch-2.0%2B-ee4c2c.svg) -->
-
-`visual-parser` is a standalone document-ingestion tool that converts PDFs into a multi-modal JSONL knowledge base (text chunks + figure descriptions + metadata). The intended workflow is:
-
-1) Run `visual-parser` on curated PDFs to generate JSONL KB files.
-2) Run RADIANT-LLM Visual-RAG for QA over the generated KB.
-
-## Outputs (JSONL KB)
-
-By default, the pipeline writes:
-- `01_chunks_kb.jsonl`: chunked text extracted from PDFs (Nougat by default).
-- `02_visuals_kb.jsonl`: figure/page visual descriptions (Vision LLM).
-- `03_metadata_kb.jsonl`: document metadata rows (title/author/etc.).
-- `04_processed_pdfs.txt`: a tracker so re-runs only process new PDFs (unless `--rebuild`).
-
-## API keys (`.env`)
-
-Provide at least one provider:
-- `OPENAI_API_KEY` (OpenAI)
-- `GEMINI_API_KEY` (Gemini)
-
-Optional:
-- `HF_TOKEN` (if you use gated Hugging Face models)
-
-## Run with Docker (Docker Hub)
-
-Prebuilt images are on **[zev94/radiant-llm](https://hub.docker.com/r/zev94/radiant-llm)** under the **visual-parser** tags:
-
-| Tag | Description |
-|-----|-------------|
-| `visual-parser-2.0` | Pinned release (v2.0) |
-| `visual-parser-latest` | Latest visual-parser build |
-
-### 1) Install Docker
-- Docker Desktop (Windows/macOS) or Docker Engine (Linux)
-
-### 2) Pull the image
-```bash
-docker pull zev94/radiant-llm:visual-parser-2.0
-```
-
-### 3) Run (input + output on the same mounted folder)
-Windows PowerShell:
-```powershell
-docker run --rm --env-file .env `
-  -v "C:\path\to\pdfs:/data" `
-  zev94/radiant-llm:visual-parser-2.0 `
-  --input-dir /data --output-dir /data
-```
-
-Linux / WSL:
-```bash
-docker run --rm --env-file .env \
-  -v "/path/to/pdfs:/data" \
-  zev94/radiant-llm:visual-parser-2.0 \
-  --input-dir /data --output-dir /data
-```
-
-### 4) Run (separate output directory)
-Windows PowerShell:
-```powershell
-docker run --rm --env-file .env `
-  -v "C:\path\to\pdfs:/data" `
-  -v "C:\path\to\out:/out" `
-  zev94/radiant-llm:visual-parser-2.0 `
-  --input-dir /data --output-dir /out
-```
-
-### Offline install (legacy `.tar`)
-
-```powershell
-docker load -i .\visual-parser_0.1.0.tar
-docker images   # use the tag printed by Docker
-```
-
-### Model overrides (optional)
-
-Default vision model is **GPT-5.5** when using `--vision-provider gpt`. Override on the command line:
-
-```powershell
-docker run --rm --env-file .env -v "C:\path\to\pdfs:/data" `
-  zev94/radiant-llm:visual-parser-2.0 `
-  --input-dir /data --output-dir /data --vision-model gpt-5.4
-```
-
-<!-- ## Run from source (Python)
-
-From `codebase/Visual-Parser/`:
-```powershell
-python visual-parser.py --input-dir "C:\path\to\pdfs"
-``` -->
-
-## Common configuration flags
-
-After pulling the image, run:
-
-```bash
-docker run --rm zev94/radiant-llm:visual-parser-2.0 --help
-```
-
-For copy-paste **Docker** examples (vision presets, text modes, workers, rebuild), see [`docker-usage-examples.md`](docker-usage-examples.md).
-
-Paths:
-- `--input-dir` / `-i` (required)
-- `--output-dir` / `-o` (default: same as input)
-
-Text extraction:
-- `--text-mode nougat|lightweight` (default: `nougat`)
-- `--nougat-model facebook/nougat-small`
-- `--chunk-size 500`
-- `--chunk-overlap 100`
-
-Vision LLM:
-- `--vision-provider gpt|gemini` (default: `gpt`)
-- `--vision-model gpt-5.2` (or `gpt-4o`, `gemini-2.5-flash`, etc.)
-- `--vision-detail low|high|auto`
-- `--reasoning-effort none|low|medium|high|xhigh`
-- `--metadata-pages 2`
-
-Performance / misc:
-- `--max-workers 4`
-- `--rebuild` (reprocess everything; ignore `04_processed_pdfs.txt`)
-- `--log-level DEBUG|INFO|WARNING|ERROR`
-
----
-
-## Citation
-
-If you use RADIANT-LLM or the accompanying evaluation materials, please cite the preprint:
-
-```bibtex
-@article{ndum2026radiant,
-  title={RADIANT-LLM: an Agentic Retrieval Augmented Generation Framework for Reliable Decision Support in Safety-Critical Nuclear Engineering},
-  author={Ndum, Zavier Ndum and Tao, Jian and Ford, John and Yim, Mansung and Liu, Yang},
-  journal={arXiv preprint arXiv:2604.22755},
-  year={2026}
-}
-```
-
-Preprint: https://arxiv.org/abs/2604.22755
-
----
-
-## License
-
-This repository is currently proprietary and not licensed for public use, redistribution, or modification. Licensing terms will be updated after institutional review.
-
-
+# visual-parser (Standalone Visual-RAG PDF Ingestion)
+
+![Python 3.12.10](https://img.shields.io/badge/Python-3.12.10-brightgreen.svg)
+<!-- ![PyTorch](https://img.shields.io/badge/PyTorch-2.0%2B-ee4c2c.svg) -->
+
+`visual-parser` is a standalone document-ingestion tool that converts PDFs into a multi-modal JSONL knowledge base (text chunks + figure descriptions + metadata). The intended workflow is:
+
+1) Run `visual-parser` on curated PDFs to generate JSONL KB files.
+2) Run RADIANT-LLM Visual-RAG for QA over the generated KB.
+
+## Outputs (JSONL KB)
+
+By default, the pipeline writes:
+- `01_chunks_kb.jsonl`: chunked text extracted from PDFs (Nougat by default).
+- `02_visuals_kb.jsonl`: figure/page visual descriptions (Vision LLM).
+- `03_metadata_kb.jsonl`: document metadata rows (title/author/etc.).
+- `04_processed_pdfs.txt`: a tracker so re-runs only process new PDFs (unless `--rebuild`).
+
+## API keys (`.env`)
+
+Provide at least one provider:
+- `OPENAI_API_KEY` (OpenAI)
+- `GEMINI_API_KEY` (Gemini)
+
+Optional:
+- `HF_TOKEN` (if you use gated Hugging Face models)
+
+## Run with Docker (Docker Hub)
+
+Prebuilt images are on **[zev94/radiant-llm](https://hub.docker.com/r/zev94/radiant-llm)** under the **visual-parser** tags:
+
+| Tag | Description |
+|-----|-------------|
+| `visual-parser-latest` | Always latest build (rolling) |
+| `visual-parser-2.0.0` | Pinned release (Apache 2.0 release) |
+| `visual-parser-1.0` | Legacy — v1.0.0, stale |
+
+### 1) Install Docker
+- Docker Desktop (Windows/macOS) or Docker Engine (Linux)
+
+### 2) Pull the image
+```bash
+docker pull zev94/radiant-llm:visual-parser-latest
+```
+
+### 3) Run (input + output on the same mounted folder)
+Windows PowerShell:
+```powershell
+docker run --rm --env-file .env `
+  -v "C:\path\to\pdfs:/data" `
+  zev94/radiant-llm:visual-parser-latest `
+  --input-dir /data --output-dir /data
+```
+
+Linux / WSL:
+```bash
+docker run --rm --env-file .env \
+  -v "/path/to/pdfs:/data" \
+  zev94/radiant-llm:visual-parser-latest \
+  --input-dir /data --output-dir /data
+```
+
+### 4) Run (separate output directory)
+Windows PowerShell:
+```powershell
+docker run --rm --env-file .env `
+  -v "C:\path\to\pdfs:/data" `
+  -v "C:\path\to\out:/out" `
+  zev94/radiant-llm:visual-parser-latest `
+  --input-dir /data --output-dir /out
+```
+
+### Offline install (legacy `.tar`)
+
+```powershell
+docker load -i .\visual-parser_0.1.0.tar
+docker images   # use the tag printed by Docker
+```
+
+### Model overrides (optional)
+
+Default vision model is **GPT-5.4** when using `--vision-provider gpt`. Override on the command line:
+
+```powershell
+docker run --rm --env-file .env -v "C:\path\to\pdfs:/data" `
+  zev94/radiant-llm:visual-parser-latest `
+  --input-dir /data --output-dir /data --vision-model gpt-5.4
+```
+
+<!-- ## Run from source (Python)
+
+From `codebase/Visual-Parser/`:
+```powershell
+python visual-parser.py --input-dir "C:\path\to\pdfs"
+``` -->
+
+## Common configuration flags
+
+After pulling the image, run:
+
+```bash
+docker run --rm zev94/radiant-llm:visual-parser-latest --help
+```
+
+For copy-paste **Docker** examples (vision presets, text modes, workers, rebuild), see [`docker-usage-examples.md`](docker-usage-examples.md).
+
+Paths:
+- `--input-dir` / `-i` (required)
+- `--output-dir` / `-o` (default: same as input)
+
+Text extraction:
+- `--text-mode nougat|lightweight` (default: `nougat`)
+- `--nougat-model facebook/nougat-small`
+- `--chunk-size 500`
+- `--chunk-overlap 100`
+
+Vision LLM:
+- `--vision-provider gpt|gemini` (default: `gpt`)
+- `--vision-model gpt-5.2` (or `gpt-4o`, `gemini-2.5-flash`, etc.)
+- `--vision-detail low|high|auto`
+- `--reasoning-effort none|low|medium|high|xhigh`
+- `--metadata-pages 2`
+
+Performance / misc:
+- `--max-workers 4`
+- `--rebuild` (reprocess everything; ignore `04_processed_pdfs.txt`)
+- `--log-level DEBUG|INFO|WARNING|ERROR`
+
+---
+
+## Citation
+
+If you use RADIANT-LLM or the accompanying evaluation materials, please cite the journal article:
+
+```bibtex
+@article{ndum2026retrieval,
+  title={A retrieval-augmented, domain-intelligent agentic framework for reliable decision support in safety-critical nuclear engineering},
+  author={Ndum, Zavier Ndum and Tao, Jian and Ford, John and Yim, Mansung and Liu, Yang},
+  journal={Reliability Engineering \& System Safety},
+  pages={113057},
+  year={2026},
+  publisher={Elsevier}
+}
+```
+
+Journal: *Reliability Engineering & System Safety* (2026), article 113057  
+Preprint: https://arxiv.org/abs/2604.22755
+
+---
+
+## License
+
+Copyright 2026 Zavier N. Ndum
+
+This project is licensed under the Apache License 2.0. See the [LICENSE](https://github.com/SmartLabNuclear/RADIANT_LLM/blob/main/LICENSE) file in the RADIANT_LLM repository for the full license text.
+
+

{visual_parser-2.0.2 → visual_parser-2.0.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "visual-parser"
-version = "2.0.2"
+version = "2.0.4"
 description = "Standalone Visual-RAG PDF Parser - text extraction and Vision-LLM figure descriptions to JSONL"
 readme = "README.md"
 requires-python = ">=3.10"

{visual_parser-2.0.2 → visual_parser-2.0.4}/visual_parser/__init__.py

@@ -17,4 +17,4 @@ from visual_parser.config import ParserConfig
 from visual_parser.pipeline import run_pipeline
 
 __all__ = ["ParserConfig", "run_pipeline"]
-__version__ = "2.0.2"
+__version__ = "1.0.2"

{visual_parser-2.0.2 → visual_parser-2.0.4}/visual_parser.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: visual-parser
-Version: 2.0.2
+Version: 2.0.4
 Summary: Standalone Visual-RAG PDF Parser - text extraction and Vision-LLM figure descriptions to JSONL
 Author: Zavier N. Ndum
 Author-email: zavier.ndum@tamu.edu
@@ -43,7 +43,6 @@ Requires-Dist: mypy; extra == "dev"
 
 # visual-parser (Standalone Visual-RAG PDF Ingestion)
 
-<!-- ![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg) -->
 ![Python 3.12.10](https://img.shields.io/badge/Python-3.12.10-brightgreen.svg)
 <!-- ![PyTorch](https://img.shields.io/badge/PyTorch-2.0%2B-ee4c2c.svg) -->
 
@@ -75,15 +74,16 @@ Prebuilt images are on **[zev94/radiant-llm](https://hub.docker.com/r/zev94/radi
 
 | Tag | Description |
 |-----|-------------|
-| `visual-parser-2.0` | Pinned release (v2.0) |
-| `visual-parser-latest` | Latest visual-parser build |
+| `visual-parser-latest` | Always latest build (rolling) |
+| `visual-parser-2.0.0` | Pinned release (Apache 2.0 release) |
+| `visual-parser-1.0` | Legacy — v1.0.0, stale |
 
 ### 1) Install Docker
 - Docker Desktop (Windows/macOS) or Docker Engine (Linux)
 
 ### 2) Pull the image
 ```bash
-docker pull zev94/radiant-llm:visual-parser-2.0
+docker pull zev94/radiant-llm:visual-parser-latest
 ```
 
 ### 3) Run (input + output on the same mounted folder)
@@ -91,7 +91,7 @@ Windows PowerShell:
 ```powershell
 docker run --rm --env-file .env `
   -v "C:\path\to\pdfs:/data" `
-  zev94/radiant-llm:visual-parser-2.0 `
+  zev94/radiant-llm:visual-parser-latest `
   --input-dir /data --output-dir /data
 ```
 
@@ -99,7 +99,7 @@ Linux / WSL:
 ```bash
 docker run --rm --env-file .env \
   -v "/path/to/pdfs:/data" \
-  zev94/radiant-llm:visual-parser-2.0 \
+  zev94/radiant-llm:visual-parser-latest \
   --input-dir /data --output-dir /data
 ```
 
@@ -109,7 +109,7 @@ Windows PowerShell:
 docker run --rm --env-file .env `
   -v "C:\path\to\pdfs:/data" `
   -v "C:\path\to\out:/out" `
-  zev94/radiant-llm:visual-parser-2.0 `
+  zev94/radiant-llm:visual-parser-latest `
   --input-dir /data --output-dir /out
 ```
 
@@ -122,11 +122,11 @@ docker images   # use the tag printed by Docker
 
 ### Model overrides (optional)
 
-Default vision model is **GPT-5.5** when using `--vision-provider gpt`. Override on the command line:
+Default vision model is **GPT-5.4** when using `--vision-provider gpt`. Override on the command line:
 
 ```powershell
 docker run --rm --env-file .env -v "C:\path\to\pdfs:/data" `
-  zev94/radiant-llm:visual-parser-2.0 `
+  zev94/radiant-llm:visual-parser-latest `
   --input-dir /data --output-dir /data --vision-model gpt-5.4
 ```
 
@@ -142,7 +142,7 @@ python visual-parser.py --input-dir "C:\path\to\pdfs"
 After pulling the image, run:
 
 ```bash
-docker run --rm zev94/radiant-llm:visual-parser-2.0 --help
+docker run --rm zev94/radiant-llm:visual-parser-latest --help
 ```
 
 For copy-paste **Docker** examples (vision presets, text modes, workers, rebuild), see [`docker-usage-examples.md`](docker-usage-examples.md).
@@ -173,23 +173,28 @@ Performance / misc:
 
 ## Citation
 
-If you use RADIANT-LLM or the accompanying evaluation materials, please cite the preprint:
+If you use RADIANT-LLM or the accompanying evaluation materials, please cite the journal article:
 
 ```bibtex
-@article{ndum2026radiant,
-  title={RADIANT-LLM: an Agentic Retrieval Augmented Generation Framework for Reliable Decision Support in Safety-Critical Nuclear Engineering},
+@article{ndum2026retrieval,
+  title={A retrieval-augmented, domain-intelligent agentic framework for reliable decision support in safety-critical nuclear engineering},
   author={Ndum, Zavier Ndum and Tao, Jian and Ford, John and Yim, Mansung and Liu, Yang},
-  journal={arXiv preprint arXiv:2604.22755},
-  year={2026}
+  journal={Reliability Engineering \& System Safety},
+  pages={113057},
+  year={2026},
+  publisher={Elsevier}
 }
 ```
 
+Journal: *Reliability Engineering & System Safety* (2026), article 113057  
 Preprint: https://arxiv.org/abs/2604.22755
 
 ---
 
 ## License
 
-This repository is currently proprietary and not licensed for public use, redistribution, or modification. Licensing terms will be updated after institutional review.
+Copyright 2026 Zavier N. Ndum
+
+This project is licensed under the Apache License 2.0. See the [LICENSE](https://github.com/SmartLabNuclear/RADIANT_LLM/blob/main/LICENSE) file in the RADIANT_LLM repository for the full license text.