// DOCUMENTATION

Choosing an AI Provider

Premium accounts get Microgamma's AI features out of the box. With the basic features you bring your own AI provider: a hosted service you have a key for, or a model running on your own network. Anything that speaks the OpenAI chat API works.

Where to set it

Open Settings → Integrations and find the AI section. It has four fields:

  • Provider — DeepSeek, OpenAI, OpenRouter, Ollama (local network), or Custom (OpenAI-compatible).
  • Base URL — filled in for each provider. Change it only if yours lives somewhere else.
  • Model — every preset has a default, so you only need to fill it in for Custom, or to pick a different model.
  • API key — required for DeepSeek, OpenAI and OpenRouter; optional for Ollama and Custom.

Which provider to pick

  • DeepSeek — cheap, and the only provider that grounds artist, album and song write-ups with a web search. See DeepSeek AI Token for getting a key.
  • OpenAI or OpenRouter — if you already have an account there. OpenRouter gives you one key for many models.
  • Ollama — a model on your own hardware. No key, no bill, and nothing leaves your network.
  • Custom — any other OpenAI-compatible server, such as llama.cpp's llama-server.

A model on your own network

AI requests are sent by your streamer, the machine that holds your library, not by our servers. So a model running on that machine or anywhere on your home network is reachable. For Ollama on another machine, pick Ollama (local network) and point the Base URL at it:

http://<host>:11434/v1

If Ollama runs on the streamer itself, the default http://localhost:11434/v1 already works. The default model is llama3.1; set Model to whatever you have pulled. For another server, pick Custom, enter its /v1 address and the model name.

Good to know

  • Write-ups are web-grounded only with DeepSeek. Other providers write from what the model already knows, so small local models may get details wrong.
  • The Similar songs section on the queue asks the AI for suggestions every time the track changes. To save on calls, switch it off with the toggle beside its title; the choice is remembered per device.
  • What the AI remembers about your taste is kept on your own machine.
  • Treat an API key like a password. You can revoke or rotate it any time from your provider's console.