Home/Docs/Frequently Asked Questions

Frequently Asked Questions

General Questions

What is Tag-AI?

Tag-AI is a desktop application that uses artificial intelligence to automatically analyze and tag your photos, making them searchable by content without manual tagging. It can process standard image formats (JPG, PNG, etc.) as well as RAW formats from various camera manufacturers.

Does Tag-AI require an internet connection?

Tag-AI only requires internet connectivity during initial installation and setup. For ongoing use, you can choose between:

How many images can Tag-AI handle?

Tag-AI has been designed to handle large image libraries. The practical limits depend on your hardware, but libraries of 100,000+ images are supported with appropriate system resources.

Does Tag-AI modify my original images?

No, Tag-AI never modifies your original images during scanning and tagging. The information is stored in Tag-AI's database. When using the "Push Tags to Image" feature, metadata is added to your image files but the actual image data remains unchanged.

Licensing

Is Tag-AI a subscription service?

No, Tag-AI is a one-time purchase. After buying a license key, you can use the software indefinitely without recurring payments.

How many computers can I use Tag-AI on?

Your Tag-AI license allows installation on up to two computers that you own (e.g., a desktop and a laptop).

How do I transfer my license to a new computer?

If you're replacing a computer, you can deactivate your license on the old device using the License Manager (accessible via the API Test tool). Then you can activate it on the new device.

Is Tag-AI open source?

Tag-AI itself is proprietary software, but it relies on several open source components. You can view the licenses for these components in the application by going to Actions → Licenses.

Performance & Hardware

Why is processing so slow on my computer?

Processing speed depends primarily on whether you have GPU acceleration properly configured. Without GPU acceleration, image processing can be 5-10x slower. Check that:

How many images can Tag-AI process per minute?

Processing speed varies widely depending on your hardware:

Can Tag-AI use multiple GPUs?

Currently, Tag-AI utilizes a single GPU. In systems with multiple GPUs, it will typically use the primary GPU.

Does Tag-AI work on Mac with Apple Silicon?

Yes, Tag-AI works on Apple Silicon Macs (M1/M2/M3) and automatically uses the integrated GPU through the Metal API. No additional setup is required for GPU acceleration on these systems.

Scanning & Processing

How does Tag-AI handle duplicate images?

Tag-AI calculates a unique hash for each image file based on its contents. If the same image exists in multiple locations, it will only be processed once. If the file is moved, Tag-AI will update the path reference in its database.

Can I pause and resume scanning?

Yes, you can stop a scan at any time by clicking the "Stop" button in the scan window. When you start a new scan later, Tag-AI will automatically skip files that have already been processed.

What happens if my computer crashes during scanning?

Tag-AI commits data to the database in batches, so most processed images will still be tagged. When you restart and scan again, it will automatically skip already-processed images and continue from where it left off.

How do I reprocess already tagged images?

To reprocess images with a different model:

  1. Change the model in Configuration (local to Gemini or vice versa)
  2. Use the Purge utility to remove the database entries for images you want to reprocess
  3. Run a new scan to process those images with the new model

Tags & Search

How many tags does Tag-AI generate per image?

The number of tags varies depending on the complexity of the image and the model used:

What kinds of things can I search for?

You can search for virtually anything visible in your images:

Why don't some obvious things appear in tags?

The AI models have certain limitations:

You can always add your own custom tags through the metadata editor.

How do I use the search syntax effectively?

Tag-AI supports several search patterns:

Privacy & Security

Does Tag-AI send my photos to a cloud service?

In the default local processing mode, your images never leave your computer. If you choose to use the Gemini API option, resized versions of your images are sent to Google's servers for processing. You can always see which mode is active in your configuration.

What data does Tag-AI collect?

Tag-AI itself does not collect or transmit any usage data or analytics. When using the local processing mode, all operations happen entirely on your device. The only external communication is for license validation, which does not involve your images or tags.

Are my tags and database encrypted?

The Tag-AI database is not encrypted by default. If you're concerned about privacy, you can place the database on an encrypted drive or partition for added security.

Advanced Topics

Can I use Tag-AI on a network drive or NAS?

Tag-AI can scan images on network drives and NAS systems, but performance will depend on your network speed. For optimal performance, we recommend:

Can I use a different AI model than the default?

Advanced users can configure Tag-AI to use alternative Ollama models:

  1. Pull the alternative model with Ollama: ollama pull bakllava
  2. Update the model_name in the Configuration Editor
  3. The model must be a multimodal vision-language model

How do I completely reset Tag-AI?

To reset Tag-AI to a fresh installation state:

  1. Close Tag-AI
  2. Delete the database file (see Database Management)
  3. Delete config.ini (see Configuration Options)
  4. Restart Tag-AI, which will run the setup wizard again