monoco_atom_doc_convert

Document Intelligence

When analyzing Office documents (.docx, .xlsx, .pptx, etc.) or PDFs, use this workflow.

Core Principles

1. No external GPU services - Do not use MinerU or other parsing services requiring task queues
2. Leverage existing Vision capabilities - Kimi CLI / Claude Code have built-in visual analysis capabilities
3. Synchronous LibreOffice calls - Local conversion, no background services needed

Conversion Workflow

Step 1: Check LibreOffice Availability

which soffice

Step 2: Convert Document to PDF

soffice --headless --convert-to pdf "{input_path}" --outdir "{output_dir}"

Step 3: Use Vision Capabilities for Analysis

The converted PDF can be directly analyzed using the Agent's visual capabilities, no additional OCR needed.

Supported Formats

Best Practices

• Temporary file management: Convert output to /tmp/ or project .monoco/tmp/
• Caching strategy: If caching parsing results is needed, use ArtifactManager for storage
• Error handling: Report specific error messages to users when conversion fails

Example

Analyze a Word document:

# Convert
soffice --headless --convert-to pdf "./report.docx" --outdir "./tmp"

# Analyze (using vision capabilities)
# Then read ./tmp/report.pdf for analysis