mistral-ocr-pdf 0.1.0

CLI tool to convert PDFs to markdown using Mistral OCR

Mistral OCR PDF

CLI tool to convert PDFs to markdown using Mistral OCR.

Installation

pip install mistral-ocr-pdf
# or with uv
uv pip install mistral-ocr-pdf

Usage

Convert a PDF to markdown:

mistral-ocr-pdf input.pdf
# Output will be saved as input.md

Specify output file:

mistral-ocr-pdf -o output.md input.pdf

Save raw OCR response JSON for debugging:

mistral-ocr-pdf --output-json response.json input.pdf

API Key Configuration

The Mistral API key can be configured in three ways:

1. Environment variable:

   export MISTRAL_API_KEY="sk-xxxx"
   mistral-ocr-pdf input.pdf
   

2. Config file:

   mistral-ocr-pdf -sk api_key -sv "sk-xxxx"
   # This saves the key to ~/.config/mistral_ocr_pdf/config.json
   

3. Direct config file editing: Create or edit ~/.config/mistral_ocr_pdf/config.json with:

   {
     "api_key": "sk-xxxx"
   }
   

Run with uv

You can also run the tool directly with uvx:

uvx mistral-ocr-pdf input.pdf