Axlfc / blip-cli

CLI port of https://replicate.com/salesforce/blip

blip-cli

CLI port of https://replicate.com/salesforce/blip

Overview

This project automates the generation of BLIP captions for images using the Replicate platform.

Installation

1. Clone the repository:

   git clone https://github.com/Axlfc/blip-cli.git

2. Install dependencies:

   pip install -r requirements.txt

Usage

Running the Script

If you have an image path as an argument:

GNU/Linux

python3 img2txt.py "/path/to/your/image.jpg"

Windows

python img2txt.py "C:\Users\Your_Username\path\to\your\image.jpg"

If you don't provide an argument, the script will prompt you to enter the image path.

Image Captions Processing Functions

Bash

To create a blip_process_single_image alias in GNU/Linux:

1. Edit ~/.bash_aliases and add:

 blip_process_single_image() {
     local script_path="path/to/img2txt.py"

     if [ -z "$1" ]; then
         echo "Usage: blip_process_single_image <image_path>"
         return 1
     fi

     local image_path="$1"
     python3 "$script_path" "$image_path"
 }

Call the function blip_process_single_image

blip_process_single_image "/path/to/single/image.jpg"

Note

Ensure the line source ~/.bash_aliases is present in ~/.bashrc.

PowerShell

To run a simple command Invoke-BlipProcessSingleImage in Windows Terminal:

Edit 'C:\Users\Your_Username\Documents\WindowsPowershell\Microsoft.PowerShell_profile.ps1' and add:

function Invoke-BlipProcessSingleImage {
    param (
        [string]$ScriptPath = "C:\path\to\img2txt.py",
        [string]$ImagePath
    )

    if (-not $ImagePath) {
        Write-Host "Usage: Invoke-BlipProcessSingleImage -ImagePath <image_path>"
        return
    }

    & python $ScriptPath $ImagePath
}

Call the function Invoke-BlipProcessSingleImage

Invoke-BlipProcessSingleImage -ImagePath "C:\path\to\single\image.jpg"

Batch Image Processing

Bash

blip_process_batch_images() {
    local script_path="path/to/img2txt.py"

    if [ -z "$1" ]; then
        echo "Usage: blip_process_batch_images <image_folder>"
        return 1
    fi

    local folder_path="$1"
    for image in $folder_path/*; do
        python3 "$script_path" "$image"
    done
}

Call the function blip_process_batch_images

blip_process_batch_images "/path/to/image/folder"

PowerShell

function Invoke-BlipProcessBatchImages {
    param (
        [string]$ScriptPath = "C:\path\to\img2txt.py",
        [string]$FolderPath
    )

    if (-not $FolderPath) {
        Write-Host "Usage: Invoke-BlipProcessBatchImages -FolderPath <image_folder>"
        return
    }

    Get-ChildItem $FolderPath | ForEach-Object {
        & python $ScriptPath $_.FullName
    }
}

Call the function Invoke-BlipProcessBatchImages

Invoke-BlipProcessBatchImages -FolderPath "C:\path\to\image\folder"

Additional Notes

• Dependencies: Ensure you have Mozilla Firefox, Python and pip installed.

Important

Adjust paths to the script files based on your project structure.