Installation

System Requirements

  • macOS with Apple Silicon (M1, M2, M3, M4, etc.)
  • Python 3.12+
  • uv package manager (required)

Note: para-files is macOS only because it uses MLX embeddings (Apple Neural Engine) and Vision Framework for OCR.

Install via GitHub 

# Clone repository
git clone https://github.com/fjacquet/para-files.git
cd para-files

# Install dependencies
uv sync --all-extras

Verify Installation

Test that everything works:

# Should show version
uv run para-files --version

# Should show help
uv run para-files --help

Next Steps

  1. Quick Setup - Configure in 5 minutes
  2. First Classification - Classify your first file
  3. Full Configuration Guide - Advanced settings

Troubleshooting

“command not found: uv”

Install uv from https://docs.astral.sh/uv/getting-started/installation/

“M1 chip required” error

This is expected if you’re not on Apple Silicon. para-files only works on macOS with M1/M2/M3/M4.

Python 3.12+ required 

# Check your Python version
python3 --version

# If you need a newer version, use uv to manage it
uv python install 3.12

Module not found errors 

# Reinstall dependencies
uv sync --all-extras