🤖 Open-source, local-first alternative to Grok Bot, OpenAI dots and Claude Duet. Your own AI bots on any model: GPT, Claude, Gemini, Grok, DeepSeek, Kimi, GLM and 70+ more through one Modelflare key. Reach them in the app, WeChat or Feishu; they remember you, work in the background, run commands and use your computer. Pay per use.
Python ai-agentai-assistantchatbotclaudecomputer-usedeepseekdesktop-appdshelectronfeishugeminigptgrokllmlocal-firstmodelflaremulti-modelopenai-compatiblepersonal-ai-agentwechat
/**
* Modelflare:本程序唯一的模型来源。
* - 三个 API 域名:modelflare.dev、origin.modelflare.dev、cf.modelflare.dev;
* 飞行中的 POST 不跨主机重定向,所以线路由用户事先选定,不自动切换。
* - 连接前用 GET {base}/models + Bearer 校验密钥;错误按状态码给出可操作的说明。
*/
import { t } from "./i18n/index.js";
// 保留历史配置值;auto/global 都指向主域名,cn 指向 origin,不代表地域或质量差异。
export type ModelflareLine = "auto" | "global" | "cn" | "cf";
export const MODELFLARE_LINES: Record<Exclude<ModelflareLine, "auto">, string> = {
global: "https://modelflare.dev/v1",
cn: "https://origin.modelflare.dev/v1",
cf: "https://cf.modelflare.dev/v1",
};
export const MODELFLARE_PROVIDER = "modelflare";
/** Modelflare 官网:登录、注册、充值、控制台都在这里(origin 域名只开放 /v1,不提供网页) */
export const MODELFLARE_WEB = "https://modelflare.dev";
/**
* 账户登录(OIDC 授权码 + PKCE,RFC 8252 原生应用)。client_id 是公开值:本程序是公共客户端,
* 没有也不需要客户端密钥;回调到本机 127.0.0.1 的临时端口。
*/
export const MODELFLARE_CLIENT_ID = "anymodel-bot";
export const MODELFLARE_SCOPES = "openid profile offline_access account api_keys";
/**
* 注册来源(Modelflare 后台按 utm_source 统计从本程序来的注册与充值)。
* 全项目统一:utm_source=anymodelbot&utm_campaign=amb_<位置>。应用内 amb_signup / amb_topup / amb_console …,
* README 与仓库文档 amb_readme,官网 amb_homepage。
*/
export const UTM = { utm_source: "anymodelbot" } as const;
/** 开发/测试:AMB_MODELFLARE_ISSUER 把登录与账户接口指向本地 mock(界面无法设置) */
export function modelflareIssuer(env: NodeJS.ProcessEnv = process.env): string {
return (env.AMB_MODELFLARE_ISSUER?.trim() || MODELFLARE_WEB).replace(/\/+$/, "");
}
/** 官网页面链接,带上来源参数 */
export function webUrl(pathname: string, campaign?: string): string {
const u = new URL(pathname, MODELFLARE_WEB);
for (const [k, v] of Object.entries(UTM)) u.searchParams.set(k, v);
if (campaign) u.searchParams.set("utm_campaign", campaign);
return u.toString();
}
export const SIGNUP_URL = webUrl("/sign-up", "amb_signup");
export const TOPUP_URL = webUrl("/billing", "amb_topup");
export const CONSOLE_URL = webUrl("/dashboard/overview", "amb_console");
/**
* 调用归因:每个经 Modelflare 的请求都带 X-Modelflare-Skill(Modelflare 只记到用量日志,
* 用来统计各集成的调用量)。版本必须是纯数字的 1–3 段。
*/
export function skillHeader(version: string): Record<string, string> {
return /^\d{1,4}(\.\d{1,4}){0,2}$/.test(version) ? { "X-Modelflare-Skill": `anymodel-bot/${version}` } : {};
}
/** 每个开启了预算的机器人有自己的内置网关 provider(自己的 API Key) */
export const BOT_PROVIDER_PREFIX = "mfb-";
export const botProviderId = (botId: string) => BOT_PROVIDER_PREFIX + botId;
const QUALIFIED = /^(modelflare|mfb-[A-Za-z0-9_-]+)\//;
/** 去掉内置网关的 provider 前缀:modelflare/openai/x、mfb-abc/openai/x → openai/x */
export function bareModel(model: string): string {
return model.replace(QUALIFIED, "");
}
/** 某个机器人专属 provider 列出的模型(模型列表里不展示,避免同一模型出现多次) */
export function isBotProviderModel(model: string): boolean {
return model.startsWith(BOT_PROVIDER_PREFIX) && model.includes("/");
}
/**
* 把模型 id 限定到某个 provider。每个请求都显式带 provider:多个 provider 提供同名模型时,
* 不带前缀的 id 会被内置网关当成一组在它们之间路由,预算就管不住了。
*/
export function routeModel(model: string, providerId: string): string {
const bare = bareModel(model.trim());
return bare ? `${providerId}/${bare}` : bare;
}
export function normalizeLine(v: unknown): ModelflareLine {
if (v === "origin") return "cn";
return v === "global" || v === "cn" || v === "cf" ? v : "auto";
}
/** 线路 → 基址。AMB_MODELFLARE_BASE_URL 仅供开发/测试(指向本地 mock),不经界面设置。 */
export function modelflareBaseUrl(line: ModelflareLine, env: NodeJS.ProcessEnv = process.env): string {
const override = env.AMB_MODELFLARE_BASE_URL?.trim();
if (override) return override.replace(/\/+$/, "");
return MODELFLARE_LINES[line === "auto" ? "global" : line];
}
/**
* 交给内置网关的三种对话接口地址:Chat Completions、Responses 都在 {base}(…/v1)下,Anthropic Messages
* 的地址是根(网关自己拼 /v1/messages)。网关按模型挑:Claude 走 Messages(提示缓存和思考过程只有它保留),
* 其余走 Chat;上游说某个模型不在这个接口上时,网关换另一个接口再试并记住。
*/
export function modelflareApiBases(baseUrl: string): { chat: string; responses: string; anthropic: string } {
return { chat: baseUrl, responses: baseUrl, anthropic: baseUrl.replace(/\/v1\/?$/, "") };
}
export type VerifyFailure = "invalid_key" | "forbidden" | "rate_limited" | "upstream" | "network" | "bad_response";
export type VerifyResult =
| {
ok: true;
models: string[];
/**
* 能对话的模型(Modelflare 标为 kind=text 的;旧版网关没有 kind 时为全部)。
* 连接时把它们全部写进内置网关的 picks:网关对超过 24 个模型、又没有 picks 的服务商
* 只放出列表前 24 个,而 Modelflare 的列表按字母排,后面的模型会被截掉。
*/
chatModels: string[];
}
| { ok: false; code: VerifyFailure; status?: number; message: string };
/** 校验密钥:只发一次 GET /models,不重试、不换线路。 */
export async function verifyModelflareKey(
baseUrl: string,
apiKey: string,
opts: { fetchImpl?: typeof fetch; timeoutMs?: number; line?: ModelflareLine } = {},
): Promise<VerifyResult> {
const f = opts.fetchImpl ?? fetch;
let res: Response;
try {
res = await f(`${baseUrl}/models`, {
headers: { Authorization: `Bearer ${apiKey}`, Accept: "application/json" },
signal: AbortSignal.timeout(opts.timeoutMs ?? 15_000),
});
} catch (e) {
const host = safeHost(baseUrl);
return {
ok: false,
code: "network",
message: t("modelflare.unreachable", { host, reason: (e as Error).name === "TimeoutError" ? t("modelflare.timeout") : (e as Error).message }),
};
}
if (res.status === 401) return { ok: false, code: "invalid_key", status: 401, message: t("modelflare.invalid_key") };
if (res.status === 403) return { ok: false, code: "forbidden", status: 403, message: t("modelflare.forbidden") };
if (res.status === 429) return { ok: false, code: "rate_limited", status: 429, message: t("modelflare.unavailable", { status: 429, retry: retryAfter(res) }) };
if (!res.ok) return { ok: false, code: "upstream", status: res.status, message: t("modelflare.unavailable", { status: res.status, retry: "" }) };
try {
const body = (await res.json()) as { data?: Array<{ id?: unknown; kind?: unknown }> };
if (!Array.isArray(body.data)) throw new Error("no data[]");
const rows = body.data.map((m) => ({ id: String(m.id ?? ""), kind: typeof m.kind === "string" ? m.kind : "" })).filter((m) => m.id);
const classified = rows.some((m) => m.kind);
return {
ok: true,
models: rows.map((m) => m.id).sort(),
chatModels: rows.filter((m) => !classified || m.kind === "text").map((m) => m.id).sort(),
};
} catch {
return { ok: false, code: "bad_response", status: res.status, message: t("modelflare.bad_models") };
}
}
function retryAfter(res: Response): string {
const s = res.headers.get("retry-after");
return s ? t("modelflare.retry_after", { s }) : "";
}
function safeHost(url: string): string {
try {
return new URL(url).host;
} catch {
return url;
}
}
/** 只用于展示的密钥尾号 */
export function keyTail(key: string): string {
return key.length > 4 ? key.slice(-4) : "";
}