Mac Guide

Use Ollama to Rename Files on Mac: Local AI Setup (2026)

Kirill Isachenko
Kirill Isachenko
Reviewed 8 min read
TL;DR: To rename files with Ollama on Mac, install Ollama, pull a vision-capable model, confirm the local service is running, select Ollama in Zush under Settings → AI Modes, and test with a small batch before using it on important folders.
Jump to section

This guide is about using an Ollama model to rename files. It does not explain how to rename an Ollama model or change a model name.

Quick answer: rename files locally on Mac with Ollama by installing Ollama, pulling the current recommended model qwen3.5:4b, then opening Settings → AI Modes → Ollama in Zush. Supported analysis content stays on your device and there are no provider API costs.

Rename files with Ollama on Mac: quick setup

  1. Install and open Ollama for macOS.
  2. Pull the recommended model: ollama pull qwen3.5:4b.
  3. Confirm it is available with ollama list.
  4. In Zush, open Settings → AI Modes → Ollama, refresh the model list, select the model, and run the connection test.
  5. Preview a small batch before applying names to an important folder.

Mac users finally have a practical way to rename files with AI without routing supported analysis content through a cloud provider. Zush’s Ollama mode connects to the local runtime, which runs a model on your Mac and returns filename suggestions for screenshots, videos, images, PDFs, and supported documents.

This guide is the hands-on Mac setup tutorial for Ollama: install, pull a model, connect, test. If you are still deciding whether to run models locally at all, read when local AI file renaming is worth the tradeoff first and come back here for the commands. Zush for Windows is live, but this article does not assume the Windows local-model setup flow is identical. For the current app page, see AI file renamer for Mac. For the broader product surface, see File Renamer for Mac and Windows. For the short setup reference, open the Ollama setup guide. If you are comparing local-first alternatives, read Zush vs AI Renamer.

What you need before starting

You need three pieces:

  • Zush for Mac with Ollama available under Settings → AI Modes on macOS 15 Sequoia or later
  • Ollama for macOS
  • a vision-capable Ollama model

Ollama has its own macOS requirement on its download page. Zush for Mac requires macOS 15 Sequoia or later and is built for modern macOS workflows with Finder, Spotlight-friendly metadata, batch rename, folder monitoring, and one-click rename history.

The important part is the model. Text-only models are not enough for file renaming because many files are visual: screenshots, videos, photos, scans, and document previews. Start with a small vision model before trying anything large.

Step 1: install Ollama

Download Ollama from the official Ollama download page, install it, and open it once. Opening the app starts the local runtime that Zush talks to.

If you prefer Terminal, Ollama also documents command-line installation on its download page. For most Mac users, the regular macOS app install is the simpler path.

Step 2: pull a vision model

Open Terminal and download one model. For most users, start with:

Terminal window
ollama pull qwen3.5:4b

The qwen3.5 library page lists multimodal variants; qwen3.5:4b is the current default in Zush’s Ollama setup. Start with that model so the guide and app agree, then compare another compatible vision model only if your hardware or naming results call for it.

Start with one model, not five. Once the first one works, you can compare speed and naming quality.

Step 3: confirm Ollama is running

In Terminal, run:

Terminal window
ollama list

You should see the model you pulled. If the list is empty, the model download did not finish or the model name was mistyped.

If Zush cannot connect, make sure Ollama is open. You can also start the local service manually:

Terminal window
ollama serve

The default local host used by the setup guide is http://127.0.0.1:11434.

Step 4: select Ollama in Zush

Open Zush and go to Settings → AI Modes → Ollama. Refresh the model list, choose qwen3.5:4b, and run the connection test.

Ollama is one of Zush’s selectable AI routes:

ModeBest forInternet required for processing
CloudEasiest setup and strong qualityYes
BYOKCloud renames with your own provider keyYes
OllamaPrivate local model processing for supported filesNo, after setup

If you process a lot of files and still want cloud models, read BYOK AI File Renaming with Your Own API Key. If you are not yet sure local processing is the right mode for your files, step back to when local AI file renaming is worth the tradeoff, which covers what local models handle well and where cloud AI is still stronger, or the broader Cloud AI vs Local AI File Renaming.

Step 5: test with a small batch

Do not test on a huge work archive first. Pick a sample folder with 10 files:

  • a few screenshots
  • one or two photos
  • a PDF or scan
  • a document export

Run the rename preview and inspect the proposed names. Good names should be descriptive without being wordy:

BeforeGood local AI name
Screenshot 2026-04-28 at 11.10.04.pngnotion-roadmap-database-sprint-plan.png
IMG_7742.HEICworkspace-desk-laptop-window-light.heic
scan_08.pdfutility-bill-april-2026.pdf
Untitled.xlsxmarketing-budget-q2-forecast.xlsx

If the names are too long, tighten your custom prompt. If they are too generic, try another model. For naming conventions, use File Naming Conventions: Best Practices for Searchable Files.

Best Mac folders to start with

Screenshots

The macOS screenshot folder fills with timestamp names. Local AI can turn those into names based on visible UI, charts, messages, and documents. For a deeper workflow, see How to Rename Screenshots Automatically on Mac.

Downloads

Downloads is where random filenames collect. Local AI helps when files are visual or text-readable. Pair it with a weekly cleanup routine from How to Organize Your Downloads Folder on Mac.

Scans and PDFs

PDFs often arrive as scan_001.pdf or document.pdf. A local vision model can help when the document preview contains enough visible context. For PDF-specific guidance, read Rename PDF Files with AI on Mac.

Photo imports

For casual photo folders, local AI can replace IMG_ names with searchable descriptions. For large professional photo archives, test carefully because local model speed can vary by hardware and image size. For more photo workflow detail, read Best Ways to Organize Photos on Mac.

Troubleshooting

Zush does not see any models

Run ollama list. If no models appear, pull a model first. Then refresh the model list in Settings → AI Modes → Ollama.

Connection test fails

Make sure Ollama is open. If needed, run ollama serve and confirm the host setting in Zush points to http://127.0.0.1:11434.

Renaming is slow

Try a smaller model, close memory-heavy apps, or switch back to Cloud for large batches where speed matters more than local processing.

Names are vague

Try a stronger model, add a custom prompt, or use Cloud/BYOK for files where naming quality matters more than offline processing.

FAQ

Can I rename files with Ollama on any Mac?

You need a Mac that can run the current Ollama macOS app and has enough memory and disk space for the model you choose. Smaller models are a better starting point for everyday Macs.

Does Zush send my files to the cloud in Ollama mode?

For supported Ollama processing, analysis content is processed by the local model instead of Zush cloud or third-party AI providers. Licensing, updates, support, or non-content operational checks may still use backend services. See the privacy policy for details.

Should I use Ollama or BYOK?

Use Ollama when local processing is the priority. Use BYOK when you want cloud renames with provider-level billing and model quality. Both are available within the 50-rename free limit and become unlimited with PRO.