modelfusion

环境要求

• Node.js 与 npm（README 未指定具体版本，建议使用较新的 LTS 版本）
• 一个支持工具调用的大模型 API Key，例如 OpenAI 的 OPENAI_API_KEY
• 一个已有的 JavaScript/TypeScript 项目或新建项目目录
• 可选：使用官方 starter 模板快速起步（terminal / Next.js + Llama.cpp / Next.js + Ollama）

安装与启动步骤

1. 1准备项目环境

   在本地准备好 Node.js 与 npm 环境，并进入你的项目目录。README 未给出 Node 版本要求，建议用 LTS。

2. 2安装 ModelFusion

   在项目根目录执行安装命令，把 modelfusion 加入依赖。这是 README 中唯一的安装命令。

   npm install modelfusion

   复制

3. 3配置模型 API 密钥

   README 说明可用环境变量提供各集成商的密钥，例如 OPENAI_API_KEY，或直接作为选项传给模型构造函数。

   export OPENAI_API_KEY=sk-xxxxxxxx

   复制

4. 4编写工具调用示例

   新建代码文件，按 README 的 runTool 示例调用 OpenAI 聊天模型并执行计算器工具。注意 README 示例中 too 应为 tool。

   import { runTool, openai } from "modelfusion";
   
   const { tool, toolCall, args, ok, result } = await runTool({
     model: openai.ChatTextGenerator({ model: "gpt-3.5-turbo" }),
     tool: calculator,
     prompt: [openai.ChatMessage.user("What's fourteen times twelve?")],
   });
   
   console.log(`Tool call:`, toolCall);
   console.log(`Tool:`, tool);
   console.log(`Arguments:`, args);
   console.log(`Ok:`, ok);
   console.log(`Result or Error:`, result);

   复制

5. 5运行并查看输出

   用你项目已有的 TypeScript/JavaScript 运行方式执行该文件。README 未指定运行命令，因此不提供具体 CLI。

关键配置

如何确认成功

运行示例后，控制台依次打印出 Tool call、Arguments 与 Result，即说明库已装好且模型调用成功。

常见问题

注意事项

• README 只给出 `npm install modelfusion` 一条安装命令，其余步骤（运行方式、Node 版本）未说明，请结合自己项目配置。
• README 顶部的 Vercel 公告提示该项目正被整合进 Vercel AI SDK，新项目建议先评估 AI SDK。
• 可用官方 starter 模板快速起步：terminal app、Next.js + Llama.cpp、Next.js + Ollama 三种。
• 更多用法与集成文档见官网 modelfusion.dev 及仓库 examples/basic 目录。