Skip to main content

What it does

Converts uploaded PDF documents into markdown text that the assistant can read and discuss. Uses Marker, an open-source PDF-to-markdown converter that handles complex layouts, tables, and OCR.

Requirements

Install Marker separately (it’s not bundled with Spaceduck):
When marker_single is on your PATH, the marker_scan tool is automatically registered at gateway startup.
Marker is GPL-3.0 with Open Rail model weight restrictions. Spaceduck never bundles Marker — it calls marker_single as an external process.

How to use it

  1. Click the paperclip button in the chat UI (or drag and drop a PDF)
  2. The file is uploaded to the gateway
  3. Ask the assistant about the document — it automatically invokes marker_scan
  4. The PDF is converted to markdown and the assistant can read and discuss it

Configuration

Set MARKER_USE_LLM=true as an environment variable to enable LLM-assisted conversion for higher-quality output on complex documents.

Troubleshooting