AI Provider Setup

Engaggit supports multiple AI providers for post analysis and draft generation. You can configure one or more providers and switch between them.

Supported Providers

Provider	Type	Notes
Ollama	Local or cloud	Local are free and runs on your machine. Requires Ollama installed and running. Ollama also provides cloud models
OpenAI	Cloud	GPT models. Requires API key.
Google Gemini	Cloud	Google's AI models. Requires API key.
Grok (xAI)	Cloud	xAI's Grok models. Requires API key.
OpenRouter	Cloud	Access to many models via a single API key.
DeepSeek	Cloud	DeepSeek's models. Requires API key.
Custom	Any	Any OpenAI-compatible endpoint (self-hosted, proxies, etc.).

Setting Up a Provider

Cloud Providers (OpenAI, Gemini, etc.)

1. Open Settings → AI Provider.
2. Select a provider from the list.
3. Enter your API key in the provider form.
4. Click Fetch Models to load available models.
5. Select a model from the dropdown.

Ollama (Local)

1. Install Ollama from ollama.ai.
2. Pull a model: ollama pull gemma4:26b (or another model of your choice).
3. Ensure Ollama is running (default: http://localhost:11434).
4. In Engaggit settings, select Ollama.
5. Click Fetch Models — your installed models will appear.
6. Select a model.

Custom Provider

For self-hosted or proxy endpoints:

1. Select Custom from the provider list.
2. Enter the base URL of your OpenAI-compatible endpoint.
3. Enter an API key (if required).
4. Type model name

Testing the Connection

Before saving a provider, you can verify that Engaggit can actually reach the AI provider and that your credentials and model are working:

1. Fill in the provider API key, base URL (if applicable), and model.
2. Click the Test connection button in the bottom-left corner of the provider form.
3. The result is shown as a toast notification:
   • Success — green toast with the model's reply confirming the connection works.
   • Error — red toast explaining the problem (invalid key, wrong URL, model name, Ollama not running, etc.).

The test sends a real request to the model, so it verifies more than just credentials — it confirms the model itself responds correctly before you save and run a scan.

Changing Providers

You can switch between configured providers at any time:

1. Open Settings → AI Provider.
2. Select a different provider from the list.
3. The new provider is used for all subsequent scans.

TIP

Different providers may produce different analysis quality. Experiment to find the best one for your use case.

API Key Security

All API keys are stored locally in an encrypted format using your operating system's secure storage. They are never transmitted anywhere except to the AI provider's API endpoint.