View Code? Open in Web Editor NEW

A Node.js CLI tool that uses Ollama models (Llama, Gemma, Phi etc.) to intelligently rename files in a specified directory

License: GNU General Public License v3.0

JavaScript 100.00%

ai-renamer's Introduction

ai-renamer

A Node.js CLI tool that uses Ollama models (Llama, Gemma, Phi etc.) to intelligently rename files in a specified directory

Preview

Rename images

ai-renamer-images-1080p.mp4

Rename files

ai-renamer-1080p.mov

Usage

You need to have Ollama and at least one LLM (Llama, Gemma etc.) installed on your system

Run with NPX

npx ai-renamer /path

Run with NPM

# Install it globally
npm install -g ai-renamer

# Run it
ai-renamer /path

Params

npx ai-renamer --help
Options:
  -h, --help          Show help                                        [boolean]
      --version       Show version number                              [boolean]
  -c, --set-case      Set the case style (e.g. camelCase, pascalCase,
                      snakeCase, kebabCase)                           [string]
  -m, --set-model     Set the Ollama model to use (e.g. gemma2, llama3) [string]
  -x, --set-chars     Set the maximum number of characters in the new filename
                      (e.g. 25)                                         [number]
  -l, --set-language  Set the output language (e.g. English, Turkish)   [string]

To get the model name to use in --set-model

ollama list

ai-renamer uses change-case library for case styling

# value: result
camelCase: twoWords
capitalCase: Two Words
constantCase: TWO_WORDS
dotCase: two.words
kebabCase: two-words
noCase: two words
pascalCase: TwoWords
pascalSnakeCase: Two_Words
pathCase: two/words
sentenceCase: Two words
snakeCase: two_words
trainCase: Two-Words