Skip to content

A reactive notebook for Python — run reproducible experiments, query with SQL, execute as a script, deploy as an app, and version with git. Stored as pure Python. All in a modern, AI-native editor.

2.0 KB
Raw Blame
/* Copyright 2026 Marimo. All rights reserved. */

import type { TypedString } from "@/utils/typed";

export const KNOWN_PROVIDERS = [
  "openai",
  "github",
  "anthropic",
  "google",
  "ollama",
  "bedrock",
  "deepseek",
  "azure",
  "openrouter",
  "wandb",
  "opencode-go",
  "marimo",
] as const;
export type KnownProviderId = (typeof KNOWN_PROVIDERS)[number];

/**
 * Provider ID can be a known provider or a custom string
 * The (string & {}) pattern allows any string while still providing autocomplete for known providers
 */
export type ProviderId = KnownProviderId | (string & {});

export type ShortModelId = TypedString<"ShortModelId">;

/**
 * Qualified model id
 * `provider_id/short_model_id`;
 */
export type QualifiedModelId = `${ProviderId}/${ShortModelId}`;

export class AiModelId {
  public readonly providerId: ProviderId;
  public readonly shortModelId: ShortModelId;

  public constructor(providerId: ProviderId, shortModelId: ShortModelId) {
    this.providerId = providerId;
    this.shortModelId = shortModelId;
  }

  public get id(): QualifiedModelId {
    return `${this.providerId}/${this.shortModelId}`;
  }

  public static parse(id: string): AiModelId {
    if (!id.includes("/")) {
      const providerId = guessProviderId(id);
      return new AiModelId(providerId, id as ShortModelId);
    }

    const [providerId, ...shortModelId] = id.split("/");
    return new AiModelId(
      providerId as ProviderId,
      shortModelId.join("/") as ShortModelId,
    );
  }
}

function guessProviderId(id: string): ProviderId {
  if (id.startsWith("gpt") || id.startsWith("o3") || id.startsWith("o1")) {
    return "openai";
  }
  if (id.startsWith("claude")) {
    return "anthropic";
  }
  if (id.startsWith("gemini") || id.startsWith("google")) {
    return "google";
  }
  if (id.startsWith("deepseek")) {
    return "deepseek";
  }
  return "ollama";
}

export function isKnownAIProvider(
  providerId: string,
): providerId is KnownProviderId {
  return (KNOWN_PROVIDERS as readonly string[]).includes(providerId);
}