ozgrozer/ai-renamer

Health v2 · maintenance only

Flags: no_releases

Adoption not part of the score

2111 stars · 142 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

A Node.js CLI tool that uses local AI models (via Ollama or LM Studio) or OpenAI to intelligently rename files based on their contents, including images, videos, and documents. It supports batch processing and saves configuration flags to a local config file for repeat use.

Use cases

• rename images based on their content with a local AI model
• batch rename videos using AI descriptions
• organize messy downloads folders with meaningful file names
• rename documents and pdfs by analyzing their text content
• use ollama llava model to generate descriptive filenames
• privately rename files offline without cloud services
• bulk rename photos with custom naming instructions

When to choose

• you want AI-powered, content-based file renaming with local models for privacy
• you need batch renaming of mixed file types (images, videos, documents)
• you prefer a simple npx-runnable CLI with persistent configuration

When to avoid

• you need a GUI-only workflow (though a separate desktop app exists)
• you have no local LLM runtime installed and don't want to pay for OpenAI
• you need deterministic rule-based renaming rather than AI-generated names

Facets

cli-tool · maturity active

cli machine-learning llm-inference image-processing video-processing workflow-automation file-system developer-tools artificial-intelligence files cli cross-platform windows file-renamer ollama lm-studio openai batch-renaming local-llm command-line automation nodejs macos linux

Member repositories

For agents

markdown · JSON · MCP: product_card(name="ozgrozer/ai-renamer")