AI RenamerRename your files with AI by their contents

AI-Renamer: Intelligent File Renaming with LLMs

AI-Renamer is a powerful Node.js CLI tool that leverages Ollama and LM Studio models (including Llava, Gemma, and Llama) to automatically rename files based on their contents.

Key Features

• Supports multiple AI providers: Ollama, LM Studio, and OpenAI
• Renames images, videos, and other file types
• Customizable naming options (case style, character limit, language)
• Configurable video frame extraction
• Support for subdirectories
• Custom prompts for fine-tuned renaming

Use Cases

• Organize large media libraries
• Streamline file management workflows
• Improve searchability of document collections
• Automate file naming conventions

Getting Started

1. Install Ollama or LM Studio with at least one LLM
2. Install ffmpeg for video renaming support
3. Run with NPX: npx ai-renamer /path
4. Or install globally: npm install -g ai-renamer

Supported Providers

• Ollama (default)
• LM Studio
• OpenAI (requires API key)

Customization

AI-Renamer offers extensive customization options:

• Provider selection
• Model specification
• API base URL
• Case styling
• Character limits
• Output language
• Subdirectory inclusion
• Custom prompts

Open Source

AI-Renamer is open source under the GPL-3.0 license. Contributions are welcome via issues and pull requests on GitHub.

View on GitHub