Skip to main content

AI Tagging

You need to set up an AI provider to use the AI tagging feature in your self-hosted instance of the app. This feature allows you to automatically tag your media files with relevant keywords, making it easier to search and organize your content.

Supported Providers​

Ollama Provider​

You can set up Ollama and pull your preferred model onto your server to use this feature. A lightweight model like the phi3:mini-4k is enough for this feature.

After that, you need to define the NEXT_PUBLIC_OLLAMA_ENDPOINT_URL and OLLAMA_MODEL environment variables inside your .env file.

Here's an example:

NEXT_PUBLIC_OLLAMA_ENDPOINT_URL=http://localhost:11434
OLLAMA_MODEL=phi3:mini-4k

OpenAI Compatible Provider​

You can use an OpenAI-compatible provider for AI tagging by defining the following environment variables in your .env file:

CUSTOM_OPENAI_BASE_URL=
OPENAI_MODEL=
OPENAI_API_KEY=

Note that if you want to use OpenAI's official API, you don't need to define the CUSTOM_OPENAI_BASE_URL variable, as it defaults to OpenAI's API URL. Here's an example of how to set it up:

OPENAI_MODEL=gpt-4o
OPENAI_API_KEY=YOUR_OPENAI_API_KEY

Another example, to use Gemini:

CUSTOM_OPENAI_BASE_URL=https://generativelanguage.googleapis.com/v1beta
OPENAI_MODEL=gemini-2.5-flash-preview-04-17
OPENAI_API_KEY=YOUR_GOOGLE_AI_STUDIO_API_KEY