Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ozgrozer/ai-renamer
A Node.js CLI that uses Ollama and LM Studio models (Llava, Gemma, Llama etc.) to intelligently rename files by their contents
https://github.com/ozgrozer/ai-renamer
ai automation cli-tool file-management file-renamer files image-renamer llama3 lm-studio machine-learning ollama openai video-renamer
Last synced: about 1 month ago
JSON representation
A Node.js CLI that uses Ollama and LM Studio models (Llava, Gemma, Llama etc.) to intelligently rename files by their contents
- Host: GitHub
- URL: https://github.com/ozgrozer/ai-renamer
- Owner: ozgrozer
- License: gpl-3.0
- Created: 2024-07-07T10:44:27.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2024-07-21T10:22:29.000Z (about 2 months ago)
- Last Synced: 2024-07-31T01:12:08.991Z (about 1 month ago)
- Topics: ai, automation, cli-tool, file-management, file-renamer, files, image-renamer, llama3, lm-studio, machine-learning, ollama, openai, video-renamer
- Language: JavaScript
- Homepage: https://x.com/ozgrozer/status/1812591967756255298
- Size: 3.17 MB
- Stars: 1,188
- Watchers: 9
- Forks: 72
- Open Issues: 6
-
Metadata Files:
- Readme: readme.md
- License: license
Awesome Lists containing this project
- jimsghstars - ozgrozer/ai-renamer - A Node.js CLI that uses Ollama and LM Studio models (Llava, Gemma, Llama etc.) to intelligently rename files by their contents (JavaScript)
README
# ai-renamer
A Node.js CLI that uses Ollama and LM Studio models (Llava, Gemma, Llama etc.) to intelligently rename files by their contents
[](https://www.npmjs.com/package/ai-renamer)
[](https://github.com/ozgrozer/ai-renamer/blob/main/license)
## Preview
Rename videos
https://github.com/user-attachments/assets/502aedba-044e-4ed5-a1c7-bca84af2f3ce
Rename images
https://github.com/ozgrozer/ai-renamer/assets/651938/0d229179-8385-4f17-a9fb-44d40c79d1e9
Rename files
https://github.com/user-attachments/assets/f8b37c3a-9cc0-48fc-aaea-f25f7b6ee4cc
## Usage
You need to have [Ollama](https://ollama.com/download) or [LM Studio](https://lmstudio.ai/) and at least one LLM (Llava, Gemma, Llama etc.) installed on your system. You need to have [ffmpeg](https://www.ffmpeg.org/download.html) to rename videos.
Run with NPX
```bash
npx ai-renamer /path
```
Run with NPM
```bash
# Install it globally
npm install -g ai-renamer
# Run it
ai-renamer /path
```
## Ollama Usage
Ollama is the default provider so you don't have to do anything. You can just run `npx ai-renamer /images`. At the first launch it will try to auto-select the Llava model but if it couldn't do that you can specify the model.
```bash
npx ai-renamer /path --provider=ollama --model=llava:13b
```
## LM Studio Usage
You need to set the provider as `lm-studio` and it will auto-select the loaded model in LM Studio.
```bash
npx ai-renamer /path --provider=lm-studio
```
## OpenAI Usage
You need to set the provider as `openai` and the api-key with your API key and it will auto-select the gpt-4o model. But you can assign any model with `--model` flag.
```bash
npx ai-renamer /path --provider=openai --api-key=OPENAI_API_KEY
```
## Custom Ports
If you're using a different port in Ollama or LM Studio you could simply specify the base URLs.
```bash
npx ai-renamer /path --provider=ollama --base-url=http://127.0.0.1:11434
npx ai-renamer /path --provider=lm-studio --base-url=http://127.0.0.1:1234
```
## Params
The values of the flags will be saved to your disk when you use them. You can find the config file at `~/ai-renamer.json`. If you're using a Mac it's `/Users/your-user-name/ai-renamer.json`. Also when you set a flag you don't have to use them again. The script gets the values from this config file.
```bash
npx ai-renamer --help
Options:
-h, --help Show help [boolean]
--version Show version number [boolean]
-p, --provider Set the provider (e.g. ollama, openai,
lm-studio) [string]
-a, --api-key Set the API key if you're using openai as
provider [string]
-u, --base-url Set the API base URL (e.g.
http://127.0.0.1:11434 for ollama) [string]
-m, --model Set the model to use (e.g. gemma2, llama3,
gpt-4o) [string]
-f, --frames Set the maximum number of frames to extract from
videos (e.g. 3, 5, 10) [number]
-c, --case Set the case style (e.g. camelCase, pascalCase,
snakeCase, kebabCase) [string]
-x, --chars Set the maximum number of characters in the new
filename (e.g. 25) [number]
-l, --language Set the output language (e.g. English, Turkish)
[string]
-s, --include-subdirectories Include files in subdirectories when processing
(e.g: true, false) [string]
-r, --custom-prompt Add a custom prompt to the LLM (e.g. "Only
describe the background") [string]
```
`ai-renamer` uses `change-case` library for case styling
```bash
# 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
```
## Contribution
Feel free to contribute. Open a new [issue](https://github.com/ozgrozer/ai-renamer/issues), or make a [pull request](https://github.com/ozgrozer/ai-renamer/pulls).
## License
[GPL-3.0](https://github.com/ozgrozer/ai-renamer/blob/main/license)