feat(compiler): added openrouter sdk support in compiler (#917)

Co-authored-by: Vaibhav Patil <[email protected]>

Author: maxprilutskiy

.changeset/tidy-drinks-lie.md

@@ -0,0 +1,7 @@
+---
+"@lingo.dev/_compiler": minor
+"@lingo.dev/_spec": patch
+"lingo.dev": patch
+---
+
+add openrouter ais support for compiler

packages/cli/package.json

@@ -128,6 +128,7 @@
     "@lingo.dev/_sdk": "workspace:*",
     "@lingo.dev/_spec": "workspace:*",
     "@modelcontextprotocol/sdk": "^1.5.0",
+    "@openrouter/ai-sdk-provider": "^0.7.1",
     "@paralleldrive/cuid2": "^2.2.2",
     "ai": "^4.3.15",
     "bitbucket": "^2.12.0",

packages/cli/src/cli/localizer/explicit.ts

@@ -1,6 +1,7 @@
 import { createAnthropic } from "@ai-sdk/anthropic";
 import { createGoogleGenerativeAI } from "@ai-sdk/google";
 import { createOpenAI } from "@ai-sdk/openai";
+import { createOpenRouter } from "@openrouter/ai-sdk-provider";
 import { I18nConfig } from "@lingo.dev/_spec";
 import chalk from "chalk";
 import dedent from "dedent";
@@ -52,6 +53,15 @@ export default function createExplicitLocalizer(
         apiKeyName: "GOOGLE_API_KEY",
         baseUrl: provider.baseUrl,
       });
+    case "openrouter":
+      return createAiSdkLocalizer({
+        factory: (params) =>
+          createOpenRouter(params).languageModel(provider.model),
+        id: provider.id,
+        prompt: provider.prompt,
+        apiKeyName: "OPENROUTER_API_KEY",
+        baseUrl: provider.baseUrl,
+      });
     case "ollama":
       return createAiSdkLocalizer({
         factory: (_params) => createOllama().languageModel(provider.model),

packages/cli/src/cli/processor/index.ts

@@ -8,6 +8,7 @@ import { createOpenAI } from "@ai-sdk/openai";
 import { colors } from "../constants";
 import { createAnthropic } from "@ai-sdk/anthropic";
 import { createGoogleGenerativeAI } from "@ai-sdk/google";
+import { createOpenRouter } from "@openrouter/ai-sdk-provider";
 import { createOllama } from "ollama-ai-provider";
 
 export default function createProcessor(
@@ -81,6 +82,17 @@ function getPureModelProvider(provider: I18nConfig["provider"]) {
         apiKey: process.env.GOOGLE_API_KEY,
       })(provider.model);
     }
+    case "openrouter": {
+      if (!process.env.OPENROUTER_API_KEY) {
+        throw new Error(
+          createMissingKeyErrorMessage("OpenRouter", "OPENROUTER_API_KEY"),
+        );
+      }
+      return createOpenRouter({
+        apiKey: process.env.OPENROUTER_API_KEY,
+        baseURL: provider.baseUrl,
+      })(provider.model);
+    }
     case "ollama": {
       // No API key check needed for Ollama
       return createOllama()(provider.model);

packages/cli/src/cli/utils/settings.ts

@@ -37,6 +37,7 @@ export function getSettings(explicitApiKey: string | undefined): CliSettings {
       anthropicApiKey: env.ANTHROPIC_API_KEY || systemFile.llm?.anthropicApiKey,
       groqApiKey: env.GROQ_API_KEY || systemFile.llm?.groqApiKey,
       googleApiKey: env.GOOGLE_API_KEY || systemFile.llm?.googleApiKey,
+      openrouterApiKey:env.OPENROUTER_API_KEY || systemFile.llm?.openrouterApiKey,
     },
   };
 }
@@ -70,6 +71,7 @@ const SettingsSchema = Z.object({
     anthropicApiKey: Z.string().optional(),
     groqApiKey: Z.string().optional(),
     googleApiKey: Z.string().optional(),
+    openrouterApiKey: Z.string().optional(),
   }),
 });
 
@@ -99,6 +101,7 @@ function _loadEnv() {
     ANTHROPIC_API_KEY: Z.string().optional(),
     GROQ_API_KEY: Z.string().optional(),
     GOOGLE_API_KEY: Z.string().optional(),
+    OPENROUTER_API_KEY: Z.string().optional(),
   })
     .passthrough()
     .parse(process.env);
@@ -122,6 +125,7 @@ function _loadSystemFile() {
       anthropicApiKey: Z.string().optional(),
       groqApiKey: Z.string().optional(),
       googleApiKey: Z.string().optional(),
+      openrouterApiKey: Z.string().optional(),
     }).optional(),
   })
     .passthrough()
@@ -192,6 +196,12 @@ function _envVarsInfo() {
       `ℹ️  Using GOOGLE_API_KEY env var instead of key from user config`,
     );
   }
+  if (env.OPENROUTER_API_KEY && systemFile.llm?.openrouterApiKey) {
+    console.info(
+      "\x1b[36m%s\x1b[0m",
+      `ℹ️  Using OPENROUTER_API_KEY env var instead of key from user config`,
+    );
+  }
   if (env.LINGODOTDEV_API_URL) {
     console.info(
       "\x1b[36m%s\x1b[0m",

packages/compiler/package.json

@@ -42,6 +42,7 @@
     "@babel/parser": "^7.26.7",
     "@babel/traverse": "^7.27.4",
     "@babel/types": "^7.26.7",
+    "@openrouter/ai-sdk-provider": "^0.7.1",
     "ai": "^4.2.10",
     "dedent": "^1.6.0",
     "dotenv": "^16.4.5",

packages/compiler/src/lib/lcp/api/index.ts

@@ -1,5 +1,6 @@
 import { createGroq } from "@ai-sdk/groq";
 import { createGoogleGenerativeAI } from "@ai-sdk/google";
+import { createOpenRouter } from '@openrouter/ai-sdk-provider';
 import { createOllama } from "ollama-ai-provider";
 import { generateText } from "ai";
 import { DictionarySchema } from "../schema";
@@ -13,6 +14,8 @@ import {
   getGroqKeyFromEnv,
   getGoogleKey,
   getGoogleKeyFromEnv,
+  getOpenRouterKey,
+  getOpenRouterKeyFromEnv,
 } from "../../../utils/llm-api-key";
 import dedent from "dedent";
 import { isRunningInCIOrDocker } from "../../../utils/env";
@@ -251,6 +254,27 @@ export class LCPAPI {
           `Creating Google Generative AI client for ${targetLocale} using model ${modelId}`,
         );
         return createGoogleGenerativeAI({ apiKey: googleKey })(modelId);
+      } 
+      case "openrouter": {
+        // Specific check for CI/CD or Docker missing OpenRouter key
+        if (isRunningInCIOrDocker()) {
+          const openRouterFromEnv = getOpenRouterKeyFromEnv();
+          if (!openRouterFromEnv) {
+            this._failMissingLLMKeyCi(providerId);
+          }
+        }
+        const openRouterKey = getOpenRouterKey();
+        if (!openRouterKey) {
+          throw new Error(
+            "⚠️  OpenRouter API key not found. Please set OPENROUTER_API_KEY environment variable or configure it user-wide.",
+          );
+        }
+        console.log(
+          `Creating OpenRouter client for ${targetLocale} using model ${modelId}`,
+        );
+        return createOpenRouter({
+          apiKey: openRouterKey,
+        })(modelId);
       }
 
       case "ollama": {

packages/compiler/src/lib/lcp/api/provider-details.ts

@@ -1,3 +1,5 @@
+import { openrouter } from "@openrouter/ai-sdk-provider";
+
 export const providerDetails: Record<
   string,
   {
@@ -22,6 +24,13 @@ export const providerDetails: Record<
     getKeyLink: "https://ai.google.dev/",
     docsLink: "https://ai.google.dev/gemini-api/docs/troubleshooting",
   },
+  openrouter: {
+    name: "OpenRouter",
+    apiKeyEnvVar: "OPENROUTER_API_KEY",
+    apiKeyConfigKey: "llm.openrouterApiKey",
+    getKeyLink: "https://openrouter.ai",
+    docsLink: "https://openrouter.ai/docs",
+  },
   ollama: {
     name: "Ollama",
     apiKeyEnvVar: undefined, // Ollama doesn't require an API key

packages/compiler/src/utils/llm-api-key.ts

@@ -48,3 +48,13 @@ export function getGoogleKeyFromRc() {
 export function getGoogleKeyFromEnv() {
   return getKeyFromEnv("GOOGLE_API_KEY");
 }
+
+export function getOpenRouterKey() {
+  return getOpenRouterKeyFromEnv() || getOpenRouterKeyFromRc();
+}
+export function getOpenRouterKeyFromRc() {
+  return getKeyFromRc("llm.openrouterApiKey");
+}
+export function getOpenRouterKeyFromEnv() {
+  return getKeyFromEnv("OPENROUTER_API_KEY");
+}

packages/spec/src/config.ts

@@ -254,7 +254,7 @@ export const configV1_4Definition = extendConfigDefinition(
 // v1.4 -> v1.5
 // Changes: add "provider" field to the config
 const providerSchema = Z.object({
-  id: Z.enum(["openai", "anthropic", "google", "ollama"]),
+  id: Z.enum(["openai", "anthropic", "google", "ollama", "openrouter"]),
   model: Z.string(),
   prompt: Z.string(),
   baseUrl: Z.string().optional(),