ai-renamer

Why we included this project

Most downloads folders are full of IMG_2041.jpg and video_0003.mp4, and renaming them by hand is tedious. This Node.js CLI points a local vision or language model at each file, reads what is actually in it, and writes a descriptive filename, so you end up with names that tell you what the file is. It runs through Ollama or LM Studio with models like Llava and Gemma, which keeps everything on your own machine if you would rather not send private files to a third-party API, though an OpenAI provider is there if you prefer a hosted model. Flags cover the practical details: naming style like snake_case or kebabCase, maximum filename length, output language, and a custom prompt to steer what the model focuses on. For anyone with large media or archive collections who wants consistent, content-aware names without the manual grind, it is a small tool that does one job well.