llama-scan

A tool for converting PDFs to text files using Ollama or OpenRouter.

Features

• Convert PDFs to text files locally, no token costs.
• Use the latest multimodal models supported by Ollama and OpenRouter.
• Turn images and diagrams into detailed text descriptions.

Requirements

• Python 3.10+
• Ollama installed and running locally, unless you select another provider.
• An OpenRouter API key in OPENROUTER_API_KEY when using --provider openrouter .

Installing Ollama and the Default Model

1. Install Ollama
2. Pull the default model:

ollama run qwen2.5vl:latest

Installation

Install using pip:

pip install llama-scan

or uv:

uv tool install llama-scan

Usage

Basic usage:

llama-scan path/to/your/file.pdf

Process specific pages:

llama-scan document.pdf --start 1 --end 5

Use a different model (Ollama):

llama-scan document.pdf --model qwen2.5vl:3b

Options

The following options can be used to customize PDF processing.

General

Model configuration

Image processing

Python API

In addition to the command-line interface (CLI), llama-scan can be used directly in Python scripts. This allows you to integrate PDF processing into your own applications and workflows.

from llama_scan import process_pdf

merged = process_pdf("document.pdf", "output")
print(merged.read_text(encoding="utf-8"))