Skip to main content

Overview

KaireonAI’s AI features (chat assistant, insights, content intelligence, rule builder) can run against any OpenAI-compatible LLM endpoint. This guide covers self-hosted options for environments where external API calls are not permitted.

Quick Start with Ollama

Ollama is the fastest way to run a local LLM. It runs on Mac, Linux, and Windows.

1. Install Ollama

2. Pull a Model

3. Start Ollama

Ollama runs on http://localhost:11434 by default.

4. Configure in KaireonAI

Navigate to Settings > AI Configuration and set: Or via API:

Other Self-Hosted Options

vLLM (GPU Server)

Best for production deployments with GPU instances.
Configure in KaireonAI:
  • Provider: openai (vLLM is OpenAI-compatible)
  • Base URL: http://your-gpu-server:8000/v1
  • Model: meta-llama/Llama-3.1-8B-Instruct

LM Studio (Desktop)

Download from lmstudio.ai, load a model, and start the local server. Configure in KaireonAI:
  • Provider: lm_studio
  • Base URL: http://localhost:1234/v1
  • Model: (auto-detected)

HuggingFace Text Generation Inference

Configure: Provider openai, Base URL http://localhost:8080/v1

Supported Providers

Bring Your Own Key (BYOK)

On the KaireonAI Playground (playground.kaireonai.com), each registered user can configure their own LLM provider:
  1. Go to Settings > AI Configuration
  2. Select your preferred provider
  3. Enter your API key (encrypted at rest, never shared)
  4. Your key is scoped to your tenant only
API keys are encrypted using AES-256 before storage. They are never returned in API responses — only **** masking is shown. Keys can be rotated at any time without affecting other tenants.

Model Recommendations

Docker Deployment with Ollama

For Docker-based deployments, add Ollama as a sidecar: