Troubleshooting

Solutions for common issues with para-files.

Common Issues

Problem Solution
Files going to Inbox Improve classification accuracy
Low confidence scores Adjust thresholds
Slow model download Configure caching

Quick Diagnostics 

# Check configuration
para-files config

# Test a specific file
para-files classify document.pdf --verbose

# Test routing rules
para-files test-route "document_name.pdf"

# View available routes
para-files routes

Getting Help

If you can’t find a solution here:

  1. Check the GitHub Issues
  2. Search existing issues for your problem
  3. Open a new issue with:
    • para-files version (para-files --version)
    • macOS version
    • Steps to reproduce
    • Expected vs actual behavior

Table of contents