Installation

Install via pip:

pip install purrfectkit

Install via git:

pip install -U git+https://github.com/suwalutions/PurrfectKit.git

Install from source:

git clone https://github.com/suwalutions/PurrfectKit.git
pip installl -U PurrfectKit/.

Prerequisites

Before installing PurrfectKit, ensure the following dependencies are installed on your system.

Linux (Ubuntu/Debian)

System Requirements

  • Python: Version 3.10 or higher

  • Tesseract OCR: Required for OCR processing or image-based PDFs

    sudo apt-get install tesseract-ocr
    
  • Thai Tesseract (optional, for Thai text recognition)

    sudo apt-get install tesseract-ocr-tha
    
  • Poppler: Required for PDF to image conversion

    sudo apt-get install poppler-utils
    
  • FFmpeg: Required for video/audio extraction and conversion

    sudo apt-get install ffmpeg
    
  • libmagic1: Used for MIME-type detection

    sudo apt-get install libmagic1
    

macOS

System Requirements

  • Python: Version 3.10 or higher

  • Tesseract OCR: Required for OCR processing or image-based PDFs

    brew install tesseract
    
  • Thai Tesseract (optional, for Thai text recognition)

    brew install tesseract-lang
    
  • Poppler: Required for PDF to image conversion

    brew install poppler
    
  • FFmpeg: Required for video/audio extraction and conversion

    brew install ffmpeg
    
  • libmagic: Used for MIME-type detection

    brew install libmagic
    

Note

For Windows users, it is recommended to install Tesseract and Poppler manually and ensure their executable paths are added to the system environment variables.