Add Cloudflare Workers AI provider (#5595)

Add Cloudflare Workers AI as a selectable OpenAI-compatible LLM provider with setup guidance and seeded model fallback.

Author: ComputelessComputer

apps/desktop/src/settings/ai/llm/configure.tsx

@@ -50,7 +50,9 @@ function ProviderContext({ providerId }: { providerId: ProviderId }) {
                 ? "Enter your **Azure AI Foundry endpoint** as the Base URL and your **API key**. Supports Claude and other models deployed via Azure AI Foundry. [Report issues](https://github.com/fastrepl/char/issues/3928)"
                 : providerId === "google_generative_ai"
                   ? "Visit [AI Studio](https://aistudio.google.com/api-keys) to create an API key."
-                  : "";
+                  : providerId === "cloudflare_workers_ai"
+                    ? "Enter the Workers AI **OpenAI-compatible base URL** as `https://api.cloudflare.com/client/v4/accounts/{account_id}/ai/v1` and use a Cloudflare API token with Workers AI access."
+                    : "";
 
   if (!content) {
     return null;

apps/desktop/src/settings/ai/llm/select.tsx

@@ -24,6 +24,7 @@ import {
 import { listAnthropicModels } from "~/settings/ai/shared/list-anthropic";
 import { listAzureAIModels } from "~/settings/ai/shared/list-azure-ai";
 import { listAzureOpenAIModels } from "~/settings/ai/shared/list-azure-openai";
+import { listCloudflareWorkersAIModels } from "~/settings/ai/shared/list-cloudflare-workers-ai";
 import {
   type InputModality,
   type ListModelsResult,
@@ -301,6 +302,10 @@ function useConfiguredMapping(): Record<string, ProviderStatus> {
           case "openai":
             listModelsFunc = () => listOpenAIModels(baseUrl, apiKey);
             break;
+          case "cloudflare_workers_ai":
+            listModelsFunc = () =>
+              listCloudflareWorkersAIModels(baseUrl, apiKey);
+            break;
           case "anthropic":
             listModelsFunc = () => listAnthropicModels(baseUrl, apiKey);
             break;

apps/desktop/src/settings/ai/llm/shared.tsx

@@ -96,6 +96,26 @@ const _PROVIDERS = [
     baseUrl: "https://api.openai.com/v1",
     requirements: [{ kind: "requires_config", fields: ["api_key"] }],
   },
+  {
+    id: "cloudflare_workers_ai",
+    displayName: "Cloudflare Workers AI",
+    badge: null,
+    icon: <Icon icon="simple-icons:cloudflare" width={16} />,
+    baseUrl: undefined,
+    requirements: [
+      { kind: "requires_config", fields: ["base_url", "api_key"] },
+    ],
+    links: {
+      models: {
+        label: "Available models",
+        url: "https://developers.cloudflare.com/workers-ai/models/",
+      },
+      setup: {
+        label: "Setup guide",
+        url: "https://developers.cloudflare.com/workers-ai/configuration/open-ai-compatibility/",
+      },
+    },
+  },
   {
     id: "anthropic",
     displayName: "Anthropic",

apps/desktop/src/settings/ai/shared/list-cloudflare-workers-ai.test.ts

@@ -0,0 +1,21 @@
+import { describe, expect, test } from "vitest";
+
+import {
+  CLOUDFLARE_WORKERS_AI_MODELS,
+  createStaticCloudflareWorkersAIModelResult,
+} from "./list-cloudflare-workers-ai";
+
+describe("createStaticCloudflareWorkersAIModelResult", () => {
+  test("keeps a selectable fallback for Workers AI chat models", () => {
+    const result = createStaticCloudflareWorkersAIModelResult();
+
+    expect(result.models).toEqual([...CLOUDFLARE_WORKERS_AI_MODELS]);
+    expect(result.models[0]).toBe("@cf/moonshotai/kimi-k2.6");
+    expect(result.metadata["@cf/moonshotai/kimi-k2.6"]).toEqual({
+      input_modalities: ["text", "image"],
+    });
+    expect(result.metadata["@cf/openai/gpt-oss-120b"]).toEqual({
+      input_modalities: ["text"],
+    });
+  });
+});

apps/desktop/src/settings/ai/shared/list-cloudflare-workers-ai.ts

@@ -0,0 +1,64 @@
+import type { ListModelsResult, ModelMetadata } from "./list-common";
+import { DEFAULT_RESULT } from "./list-common";
+
+export const CLOUDFLARE_WORKERS_AI_MODELS = [
+  "@cf/moonshotai/kimi-k2.6",
+  "@cf/zai-org/glm-4.7-flash",
+  "@cf/openai/gpt-oss-120b",
+  "@cf/meta/llama-4-scout-17b-16e-instruct",
+  "@cf/google/gemma-4-26b-a4b-it",
+  "@cf/nvidia/nemotron-3-120b-a12b",
+  "@cf/openai/gpt-oss-20b",
+  "@cf/qwen/qwen3-30b-a3b-fp8",
+  "@cf/mistralai/mistral-small-3.1-24b-instruct",
+  "@cf/meta/llama-3.3-70b-instruct-fp8-fast",
+] as const;
+
+const VISION_MODELS = new Set<string>([
+  "@cf/moonshotai/kimi-k2.6",
+  "@cf/meta/llama-4-scout-17b-16e-instruct",
+  "@cf/google/gemma-4-26b-a4b-it",
+]);
+
+function isCloudflareWorkersAIModel(
+  model: string,
+): model is (typeof CLOUDFLARE_WORKERS_AI_MODELS)[number] {
+  return (CLOUDFLARE_WORKERS_AI_MODELS as readonly string[]).includes(model);
+}
+
+export function getCloudflareWorkersAIModelMetadata(
+  model: string | undefined,
+): ModelMetadata | undefined {
+  if (!model || !isCloudflareWorkersAIModel(model)) {
+    return undefined;
+  }
+
+  return {
+    input_modalities: VISION_MODELS.has(model) ? ["text", "image"] : ["text"],
+  };
+}
+
+export function createStaticCloudflareWorkersAIModelResult(): ListModelsResult {
+  const metadata: Record<string, ModelMetadata> = {};
+
+  for (const model of CLOUDFLARE_WORKERS_AI_MODELS) {
+    metadata[model] = getCloudflareWorkersAIModelMetadata(model)!;
+  }
+
+  return {
+    models: [...CLOUDFLARE_WORKERS_AI_MODELS],
+    ignored: [],
+    metadata,
+  };
+}
+
+export async function listCloudflareWorkersAIModels(
+  baseUrl: string,
+  _apiKey: string,
+): Promise<ListModelsResult> {
+  if (!baseUrl) {
+    return DEFAULT_RESULT;
+  }
+
+  return createStaticCloudflareWorkersAIModelResult();
+}

apps/desktop/src/settings/ai/shared/model-capabilities.test.ts

@@ -30,4 +30,19 @@ describe("modelSupportsImageInput", () => {
     expect(modelSupportsImageInput("ollama", "llava:latest")).toBe(true);
     expect(modelSupportsImageInput("custom", "llama-3.1-8b")).toBe(false);
   });
+
+  it("uses Workers AI model metadata for image input support", () => {
+    expect(
+      modelSupportsImageInput(
+        "cloudflare_workers_ai",
+        "@cf/moonshotai/kimi-k2.6",
+      ),
+    ).toBe(true);
+    expect(
+      modelSupportsImageInput(
+        "cloudflare_workers_ai",
+        "@cf/openai/gpt-oss-120b",
+      ),
+    ).toBe(false);
+  });
 });

apps/desktop/src/settings/ai/shared/model-capabilities.ts

@@ -1,3 +1,5 @@
+import { getCloudflareWorkersAIModelMetadata } from "./list-cloudflare-workers-ai";
+
 const TEXT_ONLY_MODEL_RE =
   /(?:^|[/:\-.])(?:gpt-3\.5|claude-2|claude-instant|davinci|babbage|curie|ada|dall-e|sora|gpt-image|image-generation|embed|embedding|whisper|tts|transcribe|moderation|realtime|computer)(?:$|[/:\-.])/i;
 
@@ -12,6 +14,13 @@ export function modelSupportsImageInput(
     return false;
   }
 
+  if (providerId === "cloudflare_workers_ai") {
+    const metadata = getCloudflareWorkersAIModelMetadata(modelId);
+    if (metadata?.input_modalities) {
+      return metadata.input_modalities.includes("image");
+    }
+  }
+
   if (TEXT_ONLY_MODEL_RE.test(modelId)) {
     return false;
   }