# 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

Repository: https://github.com/ozgrozer/ai-renamer
Canonical: https://ross.abutalabs.com/products/ai-renamer
Homepage: https://airenamer.app
Language: JavaScript
License: GPL-3.0
License Family: copyleft
Topics: ai, automation, cli-tool, file-management, file-renamer, files, llama3, machine-learning, ollama, lm-studio, openai, image-renamer, video-renamer
Last push: 2025-02-09T14:58:12+00:00

## Health v2 (maintenance only)
Score: 26/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 5, release rhythm 35, longevity 56
- inputs: {"age_days": 787, "days_push": 570, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2111, forks 142 (observed 2026-08-28T04:06:14.270698+00:00)

## What it is
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
- artifact type: cli-tool
- maturity: active
- function: cli, machine-learning, llm-inference, image-processing, video-processing, workflow-automation, file-system
- domain: developer-tools, artificial-intelligence, files
- platform: cli, cross-platform, windows
- tags: file-renamer, ollama, lm-studio, openai, batch-renaming, local-llm, command-line, automation, nodejs, macos, linux

## Member repositories
- ozgrozer/ai-renamer (main) score 26

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:14.270698+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:53:44.048906+00:00, confidence not recorded.
  - readme: https://github.com/ozgrozer/ai-renamer (fetched 2026-08-28T04:06:14.270698+00:00, sha 587fbbbd4d24)
  - homepage: https://airenamer.app (fetched 2026-08-29T10:34:11.758291+00:00, sha 048219175597)
  - registry_npm: https://registry.npmjs.org/ai-renamer (fetched 2026-08-29T10:34:11.767658+00:00, sha 52367ac87958)
- Data as of 2026-08-30T08:39:29.467469+00:00.