# textflow | Junyi Ye | Knowledge Base | Instagit

[NAACL 2025] Beyond End-to-End VLMs: Leveraging Intermediate Text Representations for Superior Flowchart Understanding

GitHub Stars: 19

Repository: https://github.com/junyiye/textflow

---

## Articles

### [How to Log and Monitor TextFlow Pipeline Execution](/junyiye/textflow/log-monitor-textflow-pipeline-execution)

Learn to log and monitor TextFlow pipeline execution using its built-in logger. Track VQA, Textualizer, Reasoner, and Evaluation stages with timestamped files and colorized console output.

- Tags: how-to-guide
- Published: 2026-03-05

### [Understanding the Differences Between Reasoner Models in TextFlow's Textual Reasoner](/junyiye/textflow/differences-textual-reasoner-models)

Explore TextFlow's Textual Reasoner: API vs local models. Understand tool-use differences between Claude 3.5-Sonnet, GPT-4o, Llama-3.1, and Mixtral for your NLP needs.

- Tags: deep-dive
- Published: 2026-03-05

### [How to Integrate TextFlow with Your Own Applications: Complete Developer Guide](/junyiye/textflow/integrate-textflow-with-external-applications)

Integrate TextFlow into your Python apps with this developer guide. Programmatically convert flowchart images to text and perform visual question answering using modular pipeline components.

- Tags: how-to-guide
- Published: 2026-03-05

### [TextFlow Performance Optimization: 6 Best Practices for High-Throughput Flowchart Processing](/junyiye/textflow/best-practices-optimize-textflow-performance)

Boost TextFlow performance with 6 best practices. Learn to reduce processing time 2-3x by pre-encoding images and parallelizing API calls. Optimize your flowchart processing today.

- Tags: best-practices
- Published: 2026-03-05

### [How TextFlow Handles Different Flowchart Structures and Edge Cases](/junyiye/textflow/textflow-handling-flowchart-structures-edge-cases)

Discover how TextFlow handles diverse flowchart structures and edge cases like cycles and duplicates. Learn about its robust rendering strategies in flowchart.py for safe processing.

- Tags: how-to-guide
- Published: 2026-03-05

### [How to Visualize Intermediate Text Representations for Debugging in TextFlow](/junyiye/textflow/visualize-intermediate-text-representations)

Debug TextFlow effectively. Visualize intermediate text representations using JSON files, the built-in logger, or external diagram viewers like Mermaid and Graphviz.

- Tags: how-to-guide
- Published: 2026-03-05

### [How to Run Baseline VQA Comparison Against the TextFlow Pipeline](/junyiye/textflow/run-baseline-vqa-comparison)

Compare VQA models with the TextFlow pipeline. Learn how to run the baseline VQA and TextFlow comparison for accurate results using junyiye/textflow.

- Tags: how-to-guide
- Published: 2026-03-05

### [How TextFlow's Modular Architecture Enables Swapping Components](/junyiye/textflow/modular-architecture-component-swapping)

Discover how TextFlow's modular architecture lets you swap components like vision-language models and encoders easily. Edit one file, no refactoring needed, to customize your pipeline.

- Tags: internals
- Published: 2026-03-05

### [Performance Difference Between API Models and Local Models in TextFlow: A Complete Analysis](/junyiye/textflow/performance-api-vs-local-models)

Analyze TextFlow performance: API models offer 80%+ accuracy with tool use, while local models reach 60-70% lacking graph queries. Understand the gap for visual reasoning.

- Tags: performance
- Published: 2026-03-05

### [How to Debug Vision Textualizer Failures When Generated Text Representations Are Invalid](/junyiye/textflow/debug-vision-textualizer-invalid-output)

Fix Vision Textualizer invalid text generation. Debug prompt misconfigurations, missing code blocks, or image encoding issues by examining raw responses and extraction logic.

- Tags: how-to-guide
- Published: 2026-03-05

### [Prompt Templates for the Vision Textualizer and Textual Reasoner in TextFlow](/junyiye/textflow/prompt-templates-vision-textualizer-textual-reasoner)

Discover TextFlow's prompt templates for Vision Textualizer and Textual Reasoner. Generate diagrams and perform visual reasoning with these powerful LLM tools.

- Tags: api-reference
- Published: 2026-03-05

### [How to Use Ground Truth Text Representations for Benchmarking in TextFlow](/junyiye/textflow/use-ground-truth-text-representations-for-benchmarking)

Benchmark your LLM using ground truth text representations in TextFlow. Pass --textualizer Ground-Truth and provide ideal text descriptions for accurate evaluation.

- Tags: how-to-guide
- Published: 2026-03-05

### [How TextFlow Improves Explainability Over End-to-End Vision-Language Models](/junyiye/textflow/textflow-explainability-vs-end-to-end-vlms)

TextFlow enhances VLM explainability with a modular pipeline. Generate human-readable intermediate representations for precise error attribution in visual parsing and textual reasoning.

- Tags: deep-dive
- Published: 2026-03-05

### [TextFlow Evaluation Methodology: How to Assess Generated Answers and Interpret Results](/junyiye/textflow/textflow-evaluation-methodology-and-results)

Discover the TextFlow evaluation methodology. Learn how TextFlow assesses generated answers using a unique LLM-powered majority vote system and interpret performance metrics effectively.

- Tags: evaluation-methodology
- Published: 2026-03-05

### [How the Vision Textualizer Converts Flowchart Images to Structured Text Representations](/junyiye/textflow/vision-textualizer-image-to-text-conversion)

Learn how the Vision Textualizer transforms flowchart images into structured text like Mermaid or GraphViz. Discover its seven-stage pipeline and VLM integration for diagram code.

- Tags: how-to-guide
- Published: 2026-03-05

### [Datasets Supported by TextFlow and How to Prepare Custom Flowchart Data](/junyiye/textflow/supported-datasets-and-data-preparation)

Discover TextFlow datasets and learn to prepare custom flowchart data. Support for FlowVQA, FlowVQA Bottom-Top, and FlowLearn, plus easy custom dataset integration.

- Tags: how-to-guide
- Published: 2026-03-05

### [How to Add Support for a New Text Representation Format in TextFlow: A Complete Guide](/junyiye/textflow/add-new-text-representation-format)

Easily add new text representation formats to TextFlow. Follow our guide to extend prompt loaders, implement extraction functions, and register your new handler. Enhance TextFlow today.

- Tags: how-to-guide
- Published: 2026-03-05

### [How to Switch Between Different VLMs for the Vision Textualizer in TextFlow](/junyiye/textflow/switch-vlms-vision-textualizer)

Easily switch Vision-Language Models for TextFlow's Vision Textualizer. Use the --textualizer CLI argument or ModelWrapper constructor for seamless API or local inference.

- Tags: how-to-guide
- Published: 2026-03-05

### [What Local Models Are Supported by TextFlow and How to Load Them](/junyiye/textflow/supported-local-models-and-loading)

Explore TextFlow's support for 15+ local models like Llama 3.1 and Mixtral. Learn how to easily load them using the unified load_local_model interface with automatic optimization.

- Tags: how-to-guide
- Published: 2026-03-05

### [How Tool Use Works in the Textual Reasoner: Implementation and Best Practices](/junyiye/textflow/tool-use-in-textual-reasoner)

Unlock Textual Reasoner's tool use to let LLMs execute graph analysis on Mermaid flowcharts. Learn how it works and when to enable this powerful feature for accurate structural queries.

- Tags: best-practices
- Published: 2026-03-05

### [Difference Between Mermaid, Graphviz, and PlantUML Text Representations in TextFlow](/junyiye/textflow/mermaid-graphviz-plantuml-text-representations)

Compare Mermaid, Graphviz, and PlantUML text representations in TextFlow. Discover TextFlow's native support for Mermaid and LLM generation for Graphviz and PlantUML.

- Tags: deep-dive
- Published: 2026-03-05

### [How to Configure API Keys for OpenAI and Anthropic Models in TextFlow](/junyiye/textflow/configure-api-keys-openai-anthropic)

Learn how to configure API keys for OpenAI and Anthropic models in TextFlow easily. Follow our guide to set up your credentials in config.json for seamless integration.

- Tags: how-to-guide
- Published: 2026-03-05

### [TextFlow Two-Stage Architecture vs End-to-End VLM: A Technical Deep Dive for Flowchart Understanding](/junyiye/textflow/textflows-two-stage-architecture-vs-end-to-end-vlm)

Compare TextFlow two-stage architecture with end-to-end VLMs for flowchart understanding. Learn how TextFlow separates visual extraction and logical reasoning for precise results.

- Tags: deep-dive
- Published: 2026-03-05