Creating Custom Providers

Add support for new AI providers or customize existing ones to fit your needs.

Overview

While UnrealPilot comes with built-in support for major AI providers, you can extend it to work with any AI service that provides a compatible API.

Good news: If your provider has an OpenAI-compatible API, you don't need to create a custom provider - just configure the endpoint URL.

When to Create a Custom Provider

Create a custom provider when:

Non-Standard API Format

The AI service uses a different request/response format than OpenAI

Custom Authentication

Requires OAuth, custom tokens, or multi-step auth

Special Features

Provider has unique capabilities (vision, audio, etc.) you want to expose

Internal/Proprietary AI

Using a company-internal AI system

OpenAI-Compatible Providers

Many AI providers implement the OpenAI API format. For these, no custom code needed:

Configuration Steps

  1. Go to Project Settings → UnrealPilot
  2. Select "Custom OpenAI-Compatible" as provider
  3. Enter the API endpoint URL (e.g., http://localhost:11434/v1)
  4. Add your API key (if required)
  5. Choose the model name

This works with: Ollama, LM Studio, LocalAI, vLLM, Text Generation WebUI, and many others.

Custom Provider Development

For non-compatible APIs, you'll need to write C++ code to create a custom provider.

Prerequisites

  • C++ programming experience
  • Understanding of the target AI provider's API
  • Familiarity with HTTP/REST APIs
  • Unreal Engine C++ development setup

What You'll Implement

Request Formatting

Convert UnrealPilot's internal format to your provider's API format

Response Parsing

Parse the provider's responses and extract tool calls

Authentication

Handle API keys, OAuth tokens, or custom auth flows

Error Handling

Properly handle rate limits, timeouts, and API errors

Resources

GitHub Repository

Find example provider implementations and templates

→ View on GitHub

API Documentation

Reference documentation for the provider API interface

→ Read API Docs

Community Examples

See what the community has built

→ Browse Examples

Last updated: December 2025